.env.example

# ── KOBy Environment Variables ────────────────────────────────────────────
#
# Copy this file to .env and fill in all values before running.
#
#   cp .env.example .env
#
# .env is loaded by docker-compose via `env_file: .env` on the backend
# service. It is NOT committed to version control (already in .gitignore).
#
# All variables are consumed by backend/config/settings.py (pydantic-settings).
# The frontend only uses NEXT_PUBLIC_API_URL, which is set directly in
# docker-compose.yml rather than here (it is a compose service environment
# variable, not a backend secret).

# ── LLM ───────────────────────────────────────────────────────────────────
# Google AI Studio API key. Used for Gemini 2.0 Flash (LLM) and
# text-embedding-004 (production embeddings).
# Get yours at: https://aistudio.google.com/app/apikey
LLM_PROVIDER=cerebras
LLM_API_KEY=your_key_here

# ── Vector store ──────────────────────────────────────────────────────────
# Pinecone Starter (free tier) credentials.
# Get yours at: https://app.pinecone.io/
PINECONE_API_KEY=

# Name of the Pinecone index. Must be created before running ingestion.
# Dimensions: 768 (matches text-embedding-004 output).
# Metric: cosine.
PINECONE_INDEX_NAME=k8s-knowledge-base

# Pinecone namespace within the index. Use "default" unless you need
# to partition the index for different environments.
PINECONE_NAMESPACE=default

# ── Web search ────────────────────────────────────────────────────────────
# Tavily API key for the Web Search Agent.
# Get yours at: https://app.tavily.com/
TAVILY_API_KEY=

# ── Filesystem paths ──────────────────────────────────────────────────────
# These paths are relative to the container filesystem. They match the
# volume mount targets defined in docker-compose.yml.
# Do not change these unless you also change the volume mounts.

# Directory containing cluster scenario JSON files (read-only volume mount).
CLUSTER_SCENARIOS_PATH=./cluster_simulation/scenarios

# Directory containing markdown knowledge base files (read-only volume mount).
KNOWLEDGE_BASE_PATH=./knowledge_base

# Directory where the orchestrator writes TODO JSON files (writable named volume).
TODO_STORAGE_PATH=/tmp/todos

# ── Logging ───────────────────────────────────────────────────────────────
# Root log level for the backend. One of: DEBUG, INFO, WARNING, ERROR.
# Use DEBUG for development; INFO for production.
LOG_LEVEL=INFO

# ── CORS ──────────────────────────────────────────────────────────────────
# Comma-separated list of allowed origins for the FastAPI CORS middleware.
# For local development: http://localhost:3000
# For Docker Compose: the frontend is on localhost:3000 from the host perspective.
CORS_ORIGINS=["http://localhost:3000"]

EMBEDDING_PROVIDER=local
LOCAL_EMBEDDINGS=true