Get KULVEX — self-hosted AI for your home and lab →
Getting StartedConfiguration

Configuration

KULVEX is configured via environment variables in ~/.kulvex/.env. The installer generates this file automatically, but you can customize it.

Core Settings

VariableDefaultDescription
KULVEX_HOME~/.kulvexInstallation directory
KULVEX_ENVproductionEnvironment (production/development)
JWT_SECRETauto-generatedJWT signing secret
CORS_ORIGINShttp://localhost:9200Allowed CORS origins

Cloud APIs

Configure these in the web dashboard under Settings, or set them in .env:

VariableDescription
ANTHROPIC_API_KEYClaude API key (for cloud reasoning)
DEEPGRAM_API_KEYDeepgram API key (for cloud STT fallback)

Model Configuration

These are auto-configured by the model selector during install:

VariableDefaultDescription
LLAMA_CPP_ENABLEDtrueEnable local inference
LLAMA_CPP_URLhttp://kulvex-llama:8090llama-server URL
LLAMA_MODEL_PATH/models/mnemo-chat.ggufPath to GGUF model
LLAMA_MODEL_ALIASmnemoModel alias for API
GPU_COUNTauto-detectedNumber of GPUs

Dual GPU

If you have 2+ GPUs, the installer configures a second llama-server for code:

VariableDescription
LLAMA_CPP_CODE_URLCode model llama-server URL
LLAMA_CODE_MODEL_PATHCode model GGUF path
LLAMA_CODE_MODEL_ALIASCode model alias
KULVEX_CHAT_GPUGPU index for chat model
KULVEX_CODE_GPUGPU index for code model

Owner Identity

Personalize KULVEX with your identity:

VariableDescription
OWNER_NAMEYour full name
OWNER_ALIASShort alias (used in voice)
OWNER_DISPLAY_NAMEDisplay name in UI

Messaging Channels

VariableDescription
TELEGRAM_BOT_TOKENTelegram bot token
SIGNAL_CLI_URLSignal CLI REST API URL
DISCORD_BOT_TOKENDiscord bot token

Database

VariableDefaultDescription
MONGODB_URLmongodb://kulvex-mongo:27017MongoDB connection

License

VariableDescription
LICENSE_KEYYour KULVEX license key
LICENSE_SERVER_URLLicense validation server
InstallationFirst Steps