Configuration

All settings are defined in src/celine/assistant/settings.py using pydantic-settings. Values are read from environment variables or .env file.

OpenAI Settings

Variable	Type	Default	Description
`OPENAI_API_KEY`	`str`	—	OpenAI API key (required)
`OPENAI_CHAT_MODEL`	`str`	`gpt-5.4-mini`	Chat completion model
`OPENAI_EMBED_MODEL`	`str`	`text-embedding-3-small`	Embedding model for indexing and retrieval
`OPENAI_VISION_MODEL`	`str`	`gpt-4o-mini`	Vision model for image captioning

Variable	Type	Default	Description
`QDRANT_URL`	`str`	`http://host.docker.internal:6333`	Qdrant base URL
`QDRANT_API_KEY`	`str?`	—	Optional Qdrant API key
`QDRANT_COLLECTION`	`str`	`celine_docs`	Qdrant collection name

Variable	Type	Default	Description
`DATABASE_URL`	`str`	`postgresql+asyncpg://...host.docker.internal:15432/ai_assistant`	PostgreSQL async connection string
`DB_POOL_SIZE`	`int`	`10`	Connection pool size
`DB_MAX_OVERFLOW`	`int`	`20`	Max overflow connections
`DB_POOL_TIMEOUT`	`int`	`30`	Pool timeout in seconds
`DB_POOL_RECYCLE`	`int`	`1800`	Connection recycle time in seconds

Variable	Type	Default	Description
`OAUTH2_TRUST_HEADERS`	`bool`	`true`	Trust JWT from proxy headers (oauth2_proxy)
`OAUTH2_JWKS_URL`	`str?`	—	JWKS endpoint for JWT verification (auto-discovered if not set)
`OAUTH2_ISSUER`	`str?`	—	OAuth2 issuer URL
`OAUTH2_AUDIENCE`	`str?`	`oauth2_proxy`	Expected JWT audience
`OAUTH2_JWT_COOKIE_NAME`	`str?`	—	Optional JWT cookie name
`ADMIN_GROUP`	`str`	`admins`	Group name for admin access

Variable	Type	Default	Description
`TRAINING_MATERIALS_PATH`	`str`	`/workspace/repositories/celine-training-materials`	Local checkout path for training materials
`TRAINING_MATERIALS_REPO_URL`	`str`	—	Git URL to clone/pull training materials
`TRAINING_MATERIALS_REF`	`str`	`origin/main`	Git ref checked out before ingestion
`TRAINING_MATERIALS_SYNC_ON_START`	`bool`	`true`	Auto-sync training materials on startup

Variable	Type	Default	Description
`UPLOADS_URI`	`str`	`file://./data/uploads`	Upload storage URI
`MAX_UPLOAD_MB`	`int`	`25`	Maximum upload file size in MB
`INGEST_ENABLE`	`bool`	`true`	Enable RAG ingestion
`INGEST_FORCE_RELOAD_ON_START`	`bool`	`false`	Force re-ingest all documents on startup
`MANIFEST_PATH`	`str`	`/app/data/manifest.json`	Manifest file for tracking ingested documents
`DOCS_POLL_INTERVAL_SECONDS`	`int`	`60`	Polling interval for document changes

Variable	Type	Default	Description
`DIGITAL_TWIN_API_URL`	`str?`	`http://172.17.0.1:8002`	Digital Twin API for energy, weather, and forecast skills
`DATASETS_API_URL`	`str?`	`http://172.17.0.1:8001`	Dataset API (skill currently disabled — requires service tokens)
`REC_REGISTRY_API_URL`	`str?`	`http://172.17.0.1:8004`	REC Registry API for membership, assets, and delivery points
`FLEXIBILITY_API_URL`	`str?`	`http://172.17.0.1:8017`	Flexibility API for load-shift suggestions and gamification

Variable	Type	Default	Description
`MAX_TOOL_ROUNDS`	`int`	`6`	Max agentic tool-calling rounds per chat request
`MAX_TOOL_RESULT_CHARS`	`int`	`8000`	Max characters per tool result before truncation
`CHAT_HISTORY_LIMIT`	`int`	`20`	Max prior messages included in the prompt
`CHAT_WORD_LIMIT`	`int`	`25000`	Word budget for the conversation context window
`CHAT_HOT_MESSAGES`	`int`	`6`	Number of recent messages sent without summarization

Variable	Type	Default	Description
`APP_ENV`	`str`	`prod`	Application environment
`LOG_LEVEL`	`str`	`INFO`	Python log level

DATABASE_URL must use the asyncpg driver for async SQLAlchemy compatibility.
When OAUTH2_TRUST_HEADERS is true, the JWT from x-auth-request-access-token header is trusted without JWKS verification (used behind oauth2_proxy).
Upload storage defaults to local disk. The UPLOADS_URI supports file:// and s3:// schemes.
Skills (Digital Twin, Weather, Flexibility, REC Registry) are registered per-request only when the matching service URL is configured and a user token is available.