Agent skill · software engineering · nousresearch
actual-setup
Set up Actual Computer (actual.inc) inference in Hermes.
Why this skill is useful
Adds specific commands and setup procedures for integrating Actual Computer as an inference provider that the AI wouldn't reliably generate on its own.
What it needs
Requires curl installed locally. Requires actual.inc account access. About 4k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
Actual Computer Setup Skill Sets up actual.inc (Actual Computer) as a Hermes inference provider. Actual turns the user's own hardware into a private inference cluster and exposes an OpenAI-compatible API two ways: a hosted end-to-end-encrypted relay at https://api.actual.inc (authenticated with an ac key), and a local on-device daemon at http://127.0.0.1:8080 (no auth on loopback). This skill does not install the Actual daemon for the user — device authorization requires a human in a browser. When to Use User wants to add actual.inc as an inference provider (cloud relay or local). User has an ac key and wants Hermes routed through their Actual cluster. User wants fully-local, on-device inference via the Actual daemon. Troubleshooting: Actual requests failing with cryptic 400s or empty streams. Prerequisites Hermes has first-class actual provider support (provider id actual, aliases actual-computer, actualcomputer, aci). Do NOT configure Actual as a customproviders / providers.actual. entry on current Hermes — the built-in provider owns the name and handles base-url normalization, the Responses transport, and local no-auth automatically. Relay mode: an Actual account and an ac inference key from https://actual.inc/user/keys. Local mode: the user has installed the daemon (curl -fsSL "https://actual.inc/install" bash) and completed device authorization by running actual once and opening the printed https://actual.inc/device?code=... URL in a browser. Relay that URL to the user and WAIT — never invent an email or authorize on their behalf. Codes expire in 5 minutes; re-run actual for a fresh one. How to Run Relay / API mode 1. Put the key in .env (secrets only — never config.yaml): append ACTUALAPIKEY=ac... to ~/.hermes/.env. 2. Verify the key and discover models with terminal: 3. Select provider + model: 4. Verify end-to-end: Local mode 1. Human has installed + authorized the daemon (see Prerequisites). 2. Download and load a model (scriptable once authorized): 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/actual-setup