Skip to main content

​
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:
PathDescription
argent.jsonMain configuration
memory.dbMemU memory database
data/dashboard.dbTask and dashboard state
agents/main/agent/Agent templates and auth profiles
extensions/Installed plugins

​
Environment Variables

VariableDescription
ANTHROPIC_API_KEYFallback API key if auth profiles aren’t configured
ARGENT_STATE_DIROverride state directory location
ARGENT_WORKSPACEOverride agent workspace path
For the complete reference of all configuration sections and fields, see the Configuration Reference.