actual-setup

Configure Actual Computer as a Hermes inference provider via relay or local daemon.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill actual-setup-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: actual-setup
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/devops/actual-setup
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill actual-setup-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up actual.inc (Actual Computer) as an inference provider in Hermes involves two distinct modes — a hosted end-to-end-encrypted relay and a local on-device daemon — each with its own authentication, model discovery, and configuration steps, plus several cryptic failure modes that are hard to diagnose without guidance. ## Core Features & Use Cases - Relay Mode Setup: Configure Hermes to route through Actual's hosted API at api.actual.inc using an ac_ key, with model discovery via the /v1/models endpoint. - Local Daemon Mode: Point Hermes at the loopback daemon (http://127.0.0.1:8080) for fully on-device inference with automatic no-auth detection, including GGUF model search, download, and load commands. - Pitfall Diagnosis: Resolve known issues like reasoning_effort 400 errors, context-window overflow producing empty streams on small models, and download-id versus installed-name mismatches. - Use Case: A user with an ac_ key wants Hermes to run on their private Actual cluster; the skill walks through key placement in .env, provider selection, model discovery, and end-to-end verification with hermes chat. ## Quick Start Ask the agent to set up actual.inc as your Hermes inference provider using your ACTUAL_API_KEY, then verify with a test chat message.

Frequently Asked Questions about actual-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up actual.inc as a Hermes inference provider?▼

Add ACTUAL_API_KEY=ac_... to ~/.hermes/.env, discover models with curl against https://api.actual.inc/v1/models, then run hermes config set model.provider actual and set model.default to a discovered model ID. Verify with hermes chat using the actual provider.

How to run fully local inference with the Actual daemon?▼

Install and authorize the daemon, download a GGUF model with an explicit quantization like Q4_K_M, load it by its installed name, then set ACTUAL_BASE_URL=http://127.0.0.1:8080 in .env. The loopback host automatically switches the built-in provider to local no-auth mode.

Why does Actual return an empty stream with no finish_reason?▼

This happens when a small local model's context window overflows: Hermes' default toolset is about 26k tokens of schemas plus a 9k system prompt, exceeding a 32k context before the first turn. Fix it by restricting tools with -t file,web, loading with a larger n_ctx, or choosing a 64k-context model.

Should I configure Actual as a custom provider in Hermes?▼

No. Current Hermes has first-class actual provider support that owns the name and handles base-url normalization, the Responses transport, and local no-auth automatically. Stale providers.actual.* custom blocks are ignored or conflict and should be removed.

Why does actual models download fail with a 409 error?▼

Downloads require an explicit quantization suffix such as repo/QUANT (e.g. Qwen/Qwen2.5-0.5B-Instruct-GGUF/Q4_K_M); omitting it returns a 409 ambiguous_model_download error. Also note that actual models load uses the installed name from actual models list, not the download id.