Configuration
Configure Agents Machine for your workflow.
Most settings are managed through the desktop app or the encrypted vault. The MCP server reads environment variables on startup, but the desktop app handles most of them automatically.
API keys (OpenRouter, Anthropic, OpenAI, Telegram, etc.) should be stored in the vault, not in environment variables. The vault encrypts them with AES-256-GCM and injects them at runtime.
LLM Setup
Agents Machine uses OpenRouter as the primary LLM provider — one API key gives you access to Claude, GPT, Gemini, and 200+ other models.
Get an API Key Sign up at
openrouter.ai/keys and create an API key.
Store in the Vault In your IDE or desktop chat: ``` Store secret
OPENROUTER_API_KEY with value sk-or-v1-... Category: api_key Description: OpenRouter API key for LLM access ```
Done The MCP server picks up the key automatically. You can also store
direct provider keys (Anthropic, OpenAI) for specific use cases.
Environment Variables
Docker Infrastructure
The desktop app auto-manages these containers:
| Service | Port | Purpose |
|---|---|---|
| PostgreSQL | 5432 | Relational data (tasks, sessions, metadata) |
| Qdrant | 6333, 6334 | Vector database for semantic memory |
You don't need to install or configure PostgreSQL or Qdrant manually. The desktop app starts them via Docker Compose on first launch.
Workspace Directory
The app stores all data in a workspace directory: