# Honcho Environment Variables Template # Copy this file to .env and fill in the appropriate values # # Required variables are marked with (REQUIRED) # Optional variables have default values and can be left commented out # ============================================================================= # Application Settings # ============================================================================= LOG_LEVEL=INFO # SESSION_OBSERVERS_LIMIT=10 # GET_CONTEXT_MAX_TOKENS=100000 # MAX_FILE_SIZE=5242880 # Bytes # MAX_MESSAGE_SIZE=25000 # Characters # Embedding settings # EMBED_MESSAGES=true # MAX_EMBEDDING_TOKENS=8192 # MAX_EMBEDDING_TOKENS_PER_REQUEST=300000 # LANGFUSE_HOST= # LANGFUSE_PUBLIC_KEY= # NAMESPACE="honcho" # ============================================================================= # Database Settings (REQUIRED) # ============================================================================= # Connection URI for PostgreSQL database with pgvector support # Must use postgresql+psycopg prefix for SQLAlchemy compatibility DB_CONNECTION_URI=postgresql+psycopg://testuser:testpwd@localhost:5432/honcho # Optional database settings # DB_SCHEMA=public # DB_POOL_CLASS=default # DB_POOL_SIZE=10 # DB_MAX_OVERFLOW=20 # DB_POOL_TIMEOUT=30 # DB_POOL_RECYCLE=300 # DB_POOL_PRE_PING=true # DB_POOL_USE_LIFO=true # DB_SQL_DEBUG=false # DB_TRACING=false # ============================================================================= # Authentication Settings # ============================================================================= # Whether to enable authentication (set to true for production) AUTH_USE_AUTH=false # JWT secret key (REQUIRED if AUTH_USE_AUTH=true) # Generate with: python scripts/generate_jwt_secret.py # AUTH_JWT_SECRET=your-secret-key-here # ============================================================================= # LLM API Keys (REQUIRED for full functionality) # ============================================================================= # OpenAI API key for embeddings LLM_OPENAI_API_KEY=your-openai-api-key-here # Anthropic API key for dialectic and deriver functionality LLM_ANTHROPIC_API_KEY=your-anthropic-api-key-here # Google API key for summarization (if using Gemini) # LLM_GEMINI_API_KEY=your-google-api-key-here # Groq API key for query generation (if using Groq) # LLM_GROQ_API_KEY=your-groq-api-key-here # Base URL for OpenAI Compatible Requests if you want to use a different provider # LLM_OPENAI_COMPATIBLE_BASE_URL= # LLM_OPENAI_COMPATIBLE_API_KEY= # ============================================================================= # LLM Configuration # ============================================================================= # Global LLM settings # LLM_DEFAULT_MAX_TOKENS=2500 # ============================================================================= # Deriver (Background Worker) Settings # ============================================================================= # DERIVER_WORKERS=1 # DERIVER_POLLING_SLEEP_INTERVAL_SECONDS=1.0 # DERIVER_STALE_SESSION_TIMEOUT_MINUTES=5 # DERIVER_PROVIDER=google # DERIVER_MODEL=gemini-2.0-flash-lite # DERIVER_DEDUPLICATE=true # DERIVER_MAX_OUTPUT_TOKENS=2500 # only applied when using Anthropic as provider # DERIVER_THINKING_BUDGET_TOKENS=1024 # DERIVER_WORKING_REPRESENTATION_MAX_OBSERVATIONS=100 # DERIVER_REPRESENTATION_BATCH_MAX_TOKENS=4096 # DERIVER_MAX_INPUT_TOKENS=23000 # DERIVER_BACKUP_PROVIDER= # DERIVER_BACKUP_MODEL= # ============================================================================= # Peer Card Configuration # ============================================================================= # PEER_CARD_ENABLED=true # PEER_CARD_PROVIDER=openai # PEER_CARD_MODEL=gpt-5-nano-2025-08-07 # PEER_CARD_MAX_OUTPUT_TOKENS=4000 # PEER_CARD_BACKUP_PROVIDER= # PEER_CARD_BACKUP_MODEL= # ============================================================================= # Dialectic Settings # ============================================================================= # DIALECTIC_PROVIDER=anthropic # DIALECTIC_MODEL=claude-sonnet-4-20250514 # DIALECTIC_PERFORM_QUERY_GENERATION=false # DIALECTIC_QUERY_GENERATION_PROVIDER=groq # DIALECTIC_QUERY_GENERATION_MODEL=llama-3.1-8b-instant # DIALECTIC_MAX_OUTPUT_TOKENS=2500 # DIALECTIC_SEMANTIC_SEARCH_TOP_K=10 # DIALECTIC_SEMANTIC_SEARCH_MAX_DISTANCE=0.85 # DIALECTIC_THINKING_BUDGET_TOKENS=1024 # DIALECTIC_CONTEXT_WINDOW_SIZE=100000 # DIALECTIC_BACKUP_PROVIDER= # DIALECTIC_BACKUP_MODEL= # ============================================================================= # Summary Settings # ============================================================================= # SUMMARY_ENABLED=true # SUMMARY_MESSAGES_PER_SHORT_SUMMARY=20 # SUMMARY_MESSAGES_PER_LONG_SUMMARY=60 # SUMMARY_PROVIDER=google # SUMMARY_MODEL=gemini-2.5-flash # SUMMARY_MAX_TOKENS_SHORT=1000 # SUMMARY_MAX_TOKENS_LONG=2000 # SUMMARY_THINKING_BUDGET_TOKENS=512 # SUMMARY_BACKUP_PROVIDER= # SUMMARY_BACKUP_MODEL= # ============================================================================= # Dream Settings # ============================================================================= # DREAM_ENABLED=true # DREAM_DOCUMENT_THRESHOLD=50 # DREAM_IDLE_TIMEOUT_MINUTES=60 # DREAM_MIN_HOURS_BETWEEN_DREAMS=8 # DREAM_ENABLED_TYPES=["consolidate"] # DREAM_PROVIDER=openai # DREAM_MODEL=gpt-4o-mini-2024-07-18 # DREAM_MAX_TOKENS=2000 # DREAM_BACKUP_PROVIDER= # DREAM_BACKUP_MODEL= # ============================================================================= # Webhook Settings # ============================================================================= # WEBHOOK_SECRET= # WEBHOOK_MAX_WORKSPACE_LIMIT=10 # ============================================================================= # Monitoring and Observability (Optional) # ============================================================================= # Sentry error tracking # SENTRY_ENABLED=false # SENTRY_DSN=your-sentry-dsn-here # SENTRY_RELEASE=your-release-semver # SENTRY_ENVIRONMENT=development # SENTRY_TRACES_SAMPLE_RATE=0.1 # SENTRY_PROFILES_SAMPLE_RATE=0.1 # ============================================================================= # Metrics (Optional) # ============================================================================= # METRICS_ENABLED=false # METRICS_NAMESPACE=honcho # ============================================================================= # Cache # ============================================================================= # CACHE_ENABLED=false # CACHE_URL="redis://localhost:6379/0" # CACHE_NAMESPACE="honcho" # CACHE_DEFAULT_TTL_SECONDS=300 # CACHE_DEFAULT_LOCK_TTL_SECONDS=5