The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Actual Computer provider profile."""
import os
import sys
from typing import Any
from urllib.parse import urlparse
from providers import register_provider
from providers.base import ProviderProfile
DEFAULT_ACTUAL_BASE_URL = "https://api.actual.inc/v1"
class ActualProfile(ProviderProfile):
"""Actual Computer: hosted at api.actual.inc; local (offline-mode client)
inference opted into via model.base_url in config.yaml."""
def build_client_kwargs_extras(self, **context: Any) -> dict[str, Any]:
base_url = str(context.get("base_url") or self.base_url or "")
try:
hostname = (urlparse(base_url).hostname or "").lower().rstrip(".")
except ValueError:
return {}
if sys.platform != "darwin" or hostname != "api.actual.inc":
return {}
if any(
os.getenv(key)
for key in (
"HERMES_CA_BUNDLE",
"SSL_CERT_FILE",
"REQUESTS_CA_BUNDLE",
"CURL_CA_BUNDLE",
)
):
return {}
from agent.ssl_verify import certifi_bundle_path
# Re-derived when an install-environment rotation deleted the directory certifi was
# imported from: a deleted path would otherwise be handed to the client as ssl_ca_cert.
bundle = certifi_bundle_path()
return {"ssl_ca_cert": bundle} if bundle else {}
def supported_reasoning_efforts(self, model: str | None) -> tuple[str, ...] | None:
from agent.reasoning_effort import ACTUAL_RELAY_EFFORTS
return ACTUAL_RELAY_EFFORTS
def build_api_kwargs_extras(
self, *, reasoning_config: dict | None = None, **context: Any
) -> tuple[dict[str, Any], dict[str, Any]]:
if not isinstance(reasoning_config, dict):
return {}, {}
from agent.reasoning_effort import thinking_toggle_extras
# The relay accepts ``none`` as a real effort level: it switches thinking off AND
# is echoed as reasoning_effort, unlike the Moonshot/DeepSeek wires.
effort_none = str(reasoning_config.get("effort") or "").strip().lower() == "none"
if reasoning_config.get("enabled") is not False and effort_none:
return {"thinking": {"type": "disabled"}}, {"reasoning_effort": "none"}
supported = self.supported_reasoning_efforts(context.get("model")) or ()
return thinking_toggle_extras(reasoning_config, supported, always_emit_toggle=True)
def fetch_models(
self,
*,
api_key: str | None = None,
base_url: str | None = None,
timeout: float = 8.0,
) -> list[str] | None:
"""Use the selected route, then config.yaml, then the legacy environment override."""
from hermes_cli.auth import (
normalize_actual_base_url,
resolve_api_key_provider_credentials,
)
base_url = normalize_actual_base_url(
base_url or resolve_api_key_provider_credentials("actual")["base_url"]
)
return super().fetch_models(api_key=api_key, base_url=base_url, timeout=timeout)
actual = ActualProfile(
name="actual",
aliases=("actual-computer", "actualcomputer", "aci"),
display_name="Actual Computer",
description="Actual Computer - hosted inference via api.actual.inc, or local "
"offline inference via model.base_url in config.yaml",
signup_url="https://actual.inc",
env_vars=("ACTUAL_API_KEY",),
base_url=DEFAULT_ACTUAL_BASE_URL,
auth_type="api_key",
api_mode="chat_completions",
)
register_provider(actual)