Configure
Configure
Models, environment, task modes, persistence, and external services.
Configure
Architecture: This section covers the Persistence layer (vector DB, config DB, embeddings) and External services (LLM providers, secrets vault, observability). The Orchestrator and Capability layers read these settings at runtime. See How CUGA works.
CUGA behavior is driven by settings.toml, environment variables, and optional .env files. Use this section when you need to tune models, modes, storage, or platform settings — not when you are wiring tools or capabilities (see Build).
Essentials
| Topic | Layer | Page |
|---|---|---|
| LLM providers (OpenAI, WatsonX, Groq, Ollama, …) | External | Models |
.env and system variables | External | Environment |
| API / web / hybrid execution | Orchestrator | Task modes |
| Every TOML key | All | Settings reference |
Platform (Persistence + External)
| Topic | Layer | Page |
|---|---|---|
| Vector DB + embeddings for policies, knowledge, and Memory | Persistence | Storage |
| Secrets vault | External | Secrets vault |
| Auth for the server UI | Clients | Authentication |
| Tracing, Langfuse, and cuga-viz | External | Observability |
| Chat UI branding | Clients | UI branding |
Custom config directory:
export CUGA_CONFIGURATIONS_DIR="/path/to/your/configurations"Each folder under src/cuga/configurations/ holds preset model and mode TOML files you can copy and adapt.