Documentation Index
Fetch the complete documentation index at: https://docs.svantic.com/llms.txt
Use this file to discover all available pages before exploring further.
Environment & Configuration
All Svantic deployment configuration is managed through environment variables. No code changes are required to switch between topologies.
Core Variables
| Variable | Purpose | Default |
|---|
SAVANT_PORT | Port the Svantic server listens on | 3000 |
SAVANT_BASE_URL | Base URL for this Svantic instance | http://localhost:3000 |
SAVANT_CENTRAL_URL | Central hub URL (sidecar → central topology only) | — |
LLM_API_KEY | API key for the language model provider | — |
LLM_MODEL | Model to use for planning and execution | gemini-2.5-flash |
Agent Variables
| Variable | Purpose | Default |
|---|
SVANTIC_CLIENT_ID | API client ID for agent authentication | — |
SVANTIC_CLIENT_SECRET | API client secret for agent authentication | — |
SVANTIC_INSTANCE_ID | Stable instance ID (for containers/k8s) | hostname-port |
SAVANT_AGENTS_URL | URL your agent uses to reach Svantic | — |
Knowledge Store
| Variable | Purpose | Default |
|---|
CORTEX_URL | URL of the Cortex knowledge service | http://localhost:3002 |
CORTEX_MONGO_URI | MongoDB connection string for knowledge card storage | — |
EMBEDDING_MODEL | Model used for vector embeddings | — |
Database
| Variable | Purpose | Default |
|---|
DATABASE_URL | PostgreSQL connection string for the gateway | — |
REDIS_URL | Redis connection string for session state and caching | — |
Topology-Specific Configuration
Standalone
Minimal configuration — just the LLM key:
LLM_API_KEY=your-key npm run api
Sidecar
Same as standalone, but your application connects via SAVANT_AGENTS_URL:
SAVANT_AGENTS_URL=http://savant:3000 node my-app.js
Central + Sidecar
Add SAVANT_CENTRAL_URL on each sidecar to register with the hub:
SAVANT_CENTRAL_URL=http://central-savant:3000 npm run api
SAVANT_CENTRAL_URL — it is the hub.