actual-setup

Configure actual.inc as a ZeusAgent inference provider via relay or local daemon.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill actual-setup-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: actual-setup
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/devops/actual-setup
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill actual-setup-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up Actual Computer (actual.inc) as an inference provider involves two distinct modes (hosted relay and local daemon), device authorization that requires a human in a browser, and several cryptic failure modes like HTTP 400s from unsupported reasoning_effort values and empty streams from context-window overflow. This Skill walks through the correct configuration flow and documents the known pitfalls. ## Core Features & Use Cases - Relay/API Mode Setup: Store an ac_ key in ~/.zeus/.env, discover models via GET /v1/models, and set the built-in actual provider with zeus config set. - Local Daemon Mode: Search, download (with explicit quantization), and load GGUF models through the actual CLI, then point ZeusAgent at http://127.0.0.1:8080 for no-auth loopback inference. - Troubleshooting Guidance: Covers the reasoning_effort clamp (xhigh→high, ultra→max), context-window overflow on small local models, download-id vs installed-name mismatches, and empty-content reasoning models. - Use Case: A user with an Actual account wants ZeusAgent routed through their private GPU cluster; the Skill verifies the key, selects a model, and confirms end-to-end with zeus chat -Q -q "Reply with exactly: ACTUAL_OK". ## Quick Start Ask the agent to set up actual.inc as the inference provider using your ACTUAL_API_KEY and verify it 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 an inference provider?▼

Add ACTUAL_API_KEY=ac_... to ~/.zeus/.env, verify it with curl against https://api.actual.inc/v1/models, then run zeus config set model.provider actual and zeus config set model.default with a discovered model ID. Verify end-to-end with zeus chat -Q.

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

Install the daemon, run actual once and open the printed device authorization URL in a browser, then download a model with an explicit quantization and load it by its installed name. Set ACTUAL_BASE_URL=http://127.0.0.1:8080 to switch the provider into local no-auth mode.

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

This is context-window overflow, not an SSE bug. ZeusAgent's default toolset is about 26k tokens of schemas plus a 9k system prompt, which overflows a 32k-context model before the first turn. Restrict tools with -t file,web, increase n_ctx, or use a 64k+ context model.

Should I configure Actual as a custom provider in config.yaml?▼

No. ZeusAgent has first-class actual provider support with aliases actual-computer, actualcomputer, and aci. Stale providers.actual.* custom blocks are ignored or conflict; remove them and use the env vars plus model.provider flow instead.

Why do Actual model downloads fail with a 409 error?▼

Downloads require an explicit quantization suffix, otherwise the CLI returns 409 ambiguous_model_download. Use the repo/QUANT form like Qwen/Qwen2.5-0.5B-Instruct-GGUF/Q4_K_M, then load by the installed name from actual models list.