Configuration
Configure ArgentOS via argent.json and environment variables.
Configuration File
ArgentOS is configured via ~/.argentos/argent.json. This file controls the gateway, agent, channels, and all subsystems.
{
"gateway": {
"port": 18789,
"host": "0.0.0.0"
},
"agents": {
"defaults": {
"model": "claude-sonnet-4-5-20250929",
"modelRouter": {
"enabled": true,
"tiers": {
"local": { "model": "qwen3-30b-a3b:latest", "provider": "ollama" },
"fast": { "model": "claude-haiku-4-5-20251001" },
"balanced": { "model": "claude-sonnet-4-5-20250929" },
"powerful": { "model": "claude-opus-4-6" }
}
}
}
},
"workspace": "~/argent"
}State Directory
The canonical state directory is ~/.argentos/. Key contents:
| Path | Description |
|---|---|
argent.json | Main configuration |
memory.db | MemU memory database |
data/dashboard.db | Task and dashboard state |
agents/main/agent/ | Agent templates and auth profiles |
extensions/ | Installed plugins |
Environment Variables
| Variable | Description |
|---|---|
ANTHROPIC_API_KEY | Fallback API key if auth profiles aren't configured |
ARGENT_STATE_DIR | Override state directory location |
ARGENT_WORKSPACE | Override agent workspace path |