athena-agent-launcher
v0.3.3
Published
Run an Athena-configured agent locally. Resolves runtime + bindings from the Athena control plane and spawns the correct agent binary (Anthropic SDK, OpenClaw, or Hermes).
Downloads
1,037
Maintainers
Readme
athena-agent-launcher
Runs an agent configured on the Athena control plane locally on the user's machine.
# Run an agent — first run auto-prompts for credentials if missing
npx athena-agent-launcher run <agent-id>
# Optional: re-run setup later to change credentials
npx athena-agent-launcher setupFor hermes runtime agents, the launcher will auto-install the Hermes binary
silently on first run (via curl ... | bash -s -- --skip-setup), skipping Nous
Research's setup wizard. The agent uses Athena's pre-configured YAML, an
isolated HOME at ~/.athena/hermes/<agent-id>/, and the Athena
Anthropic-compatible proxy for inference.
Auth
Per-agent API key (ak_...) issued via the Athena agents table. Supplied via one of:
--api-key ak_...ATHENA_API_KEYenv var~/.athena/credentials.json→{"api_key": "ak_...", "base_url": "..."}
Flow
- Fetch
GET {base_url}/api/agents/{agentId}/launcher-manifestwithAuthorization: Bearer ak_.... - Manifest declares
runtime.kind(anthropic_sdk|openclaw|hermes) andruntime.version. - Launcher spawns
npx -y <entrypoint>with manifest env injected. The spawned runtime resolves Anthropic / Cortex credentials viaATHENA_GATEWAY_URL; raw secrets never touch the launcher or the local filesystem.
