Odysseus v1.0

.env.example

@@ -0,0 +1,102 @@
+# Odysseus UI — Environment Configuration
+# Copy this file to .env and fill in your values.
+
+# ============================================================
+# LLM Configuration
+# ============================================================
+
+# Primary LLM host (default: localhost)
+LLM_HOST=localhost
+
+# Additional LLM hosts, comma-separated (for model discovery)
+# LLM_HOSTS=llm-host.local:8000,backup-llm.local:8001
+
+# OpenAI API key (only needed if using OpenAI models).
+# Do not commit real keys. Keep this commented until needed.
+# OPENAI_API_KEY=your_openai_api_key_here
+
+# Research service LLM endpoint
+# RESEARCH_LLM_ENDPOINT=http://localhost:8000/v1/chat/completions
+
+# ============================================================
+# Search & Web
+# ============================================================
+
+# SearXNG instance URL (self-hosted, for web search).
+# Docker Compose overrides this to http://searxng:8080 for in-network access.
+SEARXNG_INSTANCE=http://localhost:8080
+
+# ============================================================
+# Database
+# ============================================================
+
+# SQLite database path (default: sqlite:///./data/app.db)
+# DATABASE_URL=sqlite:///./data/app.db
+
+# ============================================================
+# Auth & Security
+# ============================================================
+
+# Enable authentication (default: true)
+# AUTH_ENABLED=true
+
+# Development-only auth bypass for loopback requests.
+# Keep false for Docker, LAN, reverse proxy, and any shared deployment.
+# LOCALHOST_BYPASS=false
+
+# Optional: pre-seed the first admin password during setup.
+# Do not commit a real password.
+# ODYSSEUS_ADMIN_PASSWORD=change_me_before_first_boot
+
+# CORS allowed origins (default: localhost-only; restrict to your public origin in production)
+# ALLOWED_ORIGINS=http://localhost:7000,http://localhost:8000
+
+# ============================================================
+# ChromaDB (vector store)
+# ============================================================
+
+# ChromaDB service host.
+# Manual host run: localhost:8100 when using `docker run -p 8100:8000 chromadb/chroma`.
+# Docker Compose overrides these to chromadb:8000 for in-network access.
+# CHROMADB_HOST=localhost
+# CHROMADB_PORT=8100
+
+# ============================================================
+# RAG / Embeddings
+# ============================================================
+
+# Embedding API endpoint (OpenAI-compatible /v1/embeddings)
+# Default: http://{LLM_HOST}:11434/v1/embeddings (ollama)
+# EMBEDDING_URL=http://localhost:11434/v1/embeddings
+
+# Embedding model name (must be available at the endpoint above)
+# EMBEDDING_MODEL=all-minilm:l6-v2
+
+# Local fallback embedding model (used when no HTTP embedding API is available)
+# Uses fastembed (ONNX) — downloads model on first run (~50MB)
+# FASTEMBED_MODEL=sentence-transformers/all-MiniLM-L6-v2
+# FASTEMBED_CACHE_PATH=  # defaults to ~/.cache/fastembed
+
+# ============================================================
+# Misc
+# ============================================================
+
+# Cleanup interval in hours (default: 24)
+# CLEANUP_INTERVAL_HOURS=24
+
+# In-process email pollers (default: on). Set to 0 if you're driving
+# polling from cron / systemd via `scripts/odysseus-mail poll-scheduled`
+# and `scripts/odysseus-mail poll-summary`, otherwise both schedulers
+# race on the same SQLite.
+# ODYSSEUS_INPROCESS_POLLERS=1
+
+# In-process scheduled-task runner (default: on). Set to 0 to let an
+# external driver fire scheduled tasks. Calendar reminders are
+# frontend-driven (polling /api/notes from the browser) so no gate is
+# needed there.
+# ODYSSEUS_INPROCESS_TASKS=1
+
+# Host used by the built-in "run_script" scheduled-task action.
+# Empty/local/localhost runs scripts on the app host. Set to an SSH host alias
+# if you intentionally want scheduled scripts to run remotely.
+# ODYSSEUS_SCRIPT_HOST=localhost