268 lines
10 KiB
Bash
268 lines
10 KiB
Bash
# Auto Claude Environment Variables
|
|
# Copy this file to .env and fill in your values
|
|
|
|
# Claude Code OAuth Token (REQUIRED)
|
|
# Get this by running: claude setup-token
|
|
CLAUDE_CODE_OAUTH_TOKEN=your-oauth-token-here
|
|
|
|
# Model override (OPTIONAL)
|
|
# Default: claude-opus-4-5-20251101
|
|
# AUTO_BUILD_MODEL=claude-opus-4-5-20251101
|
|
|
|
# =============================================================================
|
|
# DEBUG MODE (OPTIONAL)
|
|
# =============================================================================
|
|
# Enable debug logging for development and troubleshooting.
|
|
# Shows detailed information about runner execution, agent calls, file operations.
|
|
|
|
# Enable debug mode (default: false)
|
|
# DEBUG=true
|
|
|
|
# Debug log level: 1=basic, 2=detailed, 3=verbose (default: 1)
|
|
# DEBUG_LEVEL=1
|
|
|
|
# Log to file instead of stdout (OPTIONAL)
|
|
# DEBUG_LOG_FILE=auto-claude/debug.log
|
|
|
|
# =============================================================================
|
|
# LINEAR INTEGRATION (OPTIONAL)
|
|
# =============================================================================
|
|
# Enable Linear integration for real-time progress tracking in Linear.
|
|
# Get your API key from: https://linear.app/YOUR-TEAM/settings/api
|
|
|
|
# Linear API Key (OPTIONAL - enables Linear integration)
|
|
# LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
|
|
# Pre-configured Team ID (OPTIONAL - will auto-detect if not set)
|
|
# LINEAR_TEAM_ID=
|
|
|
|
# Pre-configured Project ID (OPTIONAL - will create project if not set)
|
|
# LINEAR_PROJECT_ID=
|
|
|
|
# =============================================================================
|
|
# UI SETTINGS (OPTIONAL)
|
|
# =============================================================================
|
|
# Enable fancy terminal UI with icons, colors, and interactive menus.
|
|
# Set to "false" to use plain text output (useful for CI/CD or log files).
|
|
|
|
# Enable fancy UI (default: true)
|
|
# ENABLE_FANCY_UI=true
|
|
|
|
# =============================================================================
|
|
# GRAPHITI MEMORY INTEGRATION V2 (OPTIONAL)
|
|
# =============================================================================
|
|
# Enable Graphiti-based persistent memory layer for cross-session context
|
|
# retention. Uses FalkorDB as the graph database backend.
|
|
#
|
|
# V2 supports multiple LLM and embedder providers:
|
|
# - OpenAI (default)
|
|
# - Anthropic (LLM only, use with Voyage for embeddings)
|
|
# - Azure OpenAI
|
|
# - Ollama (local, fully offline)
|
|
#
|
|
# Prerequisites:
|
|
# 1. Start FalkorDB: docker-compose up -d falkordb
|
|
# 2. Install Graphiti: pip install graphiti-core[falkordb]
|
|
# 3. Configure your chosen provider (see below)
|
|
|
|
# Enable Graphiti integration (default: false)
|
|
# GRAPHITI_ENABLED=true
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: Provider Selection
|
|
# =============================================================================
|
|
# Choose which providers to use for LLM and embeddings.
|
|
# Default is "openai" for both.
|
|
|
|
# LLM provider: openai | anthropic | azure_openai | ollama
|
|
# GRAPHITI_LLM_PROVIDER=openai
|
|
|
|
# Embedder provider: openai | voyage | azure_openai | ollama
|
|
# GRAPHITI_EMBEDDER_PROVIDER=openai
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: OpenAI Provider (Default)
|
|
# =============================================================================
|
|
# Use OpenAI for both LLM and embeddings. This is the simplest setup.
|
|
# Required: OPENAI_API_KEY
|
|
|
|
# OpenAI API Key
|
|
# OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
|
|
# OpenAI Model for LLM (default: gpt-5-mini)
|
|
# OPENAI_MODEL=gpt-5-mini
|
|
|
|
# OpenAI Model for embeddings (default: text-embedding-3-small)
|
|
# Available: text-embedding-3-small (1536 dim), text-embedding-3-large (3072 dim)
|
|
# OPENAI_EMBEDDING_MODEL=text-embedding-3-small
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: Anthropic Provider (LLM only)
|
|
# =============================================================================
|
|
# Use Anthropic for LLM. Requires separate embedder (use Voyage or OpenAI).
|
|
# Example: GRAPHITI_LLM_PROVIDER=anthropic, GRAPHITI_EMBEDDER_PROVIDER=voyage
|
|
#
|
|
# Required: ANTHROPIC_API_KEY
|
|
|
|
# Anthropic API Key
|
|
# ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
|
|
# Anthropic Model (default: claude-sonnet-4-5-latest)
|
|
# GRAPHITI_ANTHROPIC_MODEL=claude-sonnet-4-5-latest
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: Voyage AI Provider (Embeddings only)
|
|
# =============================================================================
|
|
# Use Voyage AI for embeddings. Commonly paired with Anthropic LLM.
|
|
# Get API key from: https://www.voyageai.com/
|
|
#
|
|
# Required: VOYAGE_API_KEY
|
|
|
|
# Voyage AI API Key
|
|
# VOYAGE_API_KEY=pa-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
|
|
# Voyage Embedding Model (default: voyage-3)
|
|
# Available: voyage-3 (1024 dim), voyage-3-lite (512 dim)
|
|
# VOYAGE_EMBEDDING_MODEL=voyage-3
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: Azure OpenAI Provider
|
|
# =============================================================================
|
|
# Use Azure OpenAI for both LLM and embeddings.
|
|
# Requires Azure OpenAI deployment with appropriate models.
|
|
#
|
|
# Required: AZURE_OPENAI_API_KEY, AZURE_OPENAI_BASE_URL
|
|
|
|
# Azure OpenAI API Key
|
|
# AZURE_OPENAI_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
|
|
# Azure OpenAI Base URL (your Azure endpoint)
|
|
# AZURE_OPENAI_BASE_URL=https://your-resource.openai.azure.com/openai/deployments/your-deployment
|
|
|
|
# Azure OpenAI Deployment Names
|
|
# AZURE_OPENAI_LLM_DEPLOYMENT=gpt-5
|
|
# AZURE_OPENAI_EMBEDDING_DEPLOYMENT=text-embedding-3-small
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: Ollama Provider (Local/Offline)
|
|
# =============================================================================
|
|
# Use Ollama for fully offline operation. No API keys required.
|
|
# Requires Ollama running locally with appropriate models pulled.
|
|
#
|
|
# Prerequisites:
|
|
# 1. Install Ollama: https://ollama.ai/
|
|
# 2. Pull models: ollama pull deepseek-r1:7b && ollama pull nomic-embed-text
|
|
# 3. Start Ollama server (usually auto-starts)
|
|
#
|
|
# Required: OLLAMA_LLM_MODEL, OLLAMA_EMBEDDING_MODEL, OLLAMA_EMBEDDING_DIM
|
|
|
|
# Ollama Server URL (default: http://localhost:11434)
|
|
# OLLAMA_BASE_URL=http://localhost:11434
|
|
|
|
# Ollama LLM Model
|
|
# Popular choices: deepseek-r1:7b, llama3.2:3b, mistral:7b, phi3:medium
|
|
# OLLAMA_LLM_MODEL=deepseek-r1:7b
|
|
|
|
# Ollama Embedding Model
|
|
# Popular choices: nomic-embed-text (768 dim), mxbai-embed-large (1024 dim)
|
|
# OLLAMA_EMBEDDING_MODEL=nomic-embed-text
|
|
|
|
# Ollama Embedding Dimension (REQUIRED for Ollama embeddings)
|
|
# Must match your embedding model's output dimension
|
|
# Common values: nomic-embed-text=768, mxbai-embed-large=1024, all-minilm=384
|
|
# OLLAMA_EMBEDDING_DIM=768
|
|
|
|
# =============================================================================
|
|
# GRAPHITI MCP SERVER (OPTIONAL - Agent-accessible knowledge graph)
|
|
# =============================================================================
|
|
# Enable Graphiti MCP server for direct agent access to knowledge graph.
|
|
# This is SEPARATE from GRAPHITI_ENABLED (Python library integration).
|
|
#
|
|
# With MCP server enabled, Claude agents can directly:
|
|
# - Search for relevant context (search_nodes, search_facts)
|
|
# - Add discoveries to the graph (add_episode)
|
|
# - Retrieve recent sessions (get_episodes)
|
|
#
|
|
# Quick Start (uses docker-compose.yml in project root):
|
|
# 1. Set OPENAI_API_KEY in your .env file (or export it)
|
|
# 2. Run: docker-compose up -d
|
|
# 3. Set GRAPHITI_MCP_URL below
|
|
#
|
|
# Manual Docker (alternative):
|
|
# docker run -d -p 8000:8000 \
|
|
# -e DATABASE_TYPE=falkordb \
|
|
# -e OPENAI_API_KEY=$OPENAI_API_KEY \
|
|
# -e FALKORDB_URI=redis://host.docker.internal:6379 \
|
|
# falkordb/graphiti-knowledge-graph-mcp
|
|
#
|
|
# See: https://docs.falkordb.com/agentic-memory/graphiti-mcp-server.html
|
|
|
|
# Graphiti MCP Server URL (setting this enables MCP integration)
|
|
# GRAPHITI_MCP_URL=http://localhost:8000/mcp/
|
|
|
|
# Graphiti MCP Server Port (for docker-compose, default: 8000)
|
|
# GRAPHITI_MCP_PORT=8000
|
|
|
|
# Optional: Override model settings for MCP server
|
|
# GRAPHITI_MODEL_NAME=gpt-4o-mini
|
|
# GRAPHITI_EMBEDDING_MODEL=text-embedding-3-small
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: FalkorDB Connection Settings
|
|
# =============================================================================
|
|
# Configure the FalkorDB graph database connection.
|
|
# Start FalkorDB: docker run -p 6379:6379 falkordb/falkordb:latest
|
|
|
|
# FalkorDB Host (default: localhost)
|
|
# GRAPHITI_FALKORDB_HOST=localhost
|
|
|
|
# FalkorDB Port (default: 6379)
|
|
# GRAPHITI_FALKORDB_PORT=6379
|
|
|
|
# FalkorDB Password (default: empty)
|
|
# GRAPHITI_FALKORDB_PASSWORD=
|
|
|
|
# Graph Database Name (default: auto_claude_memory)
|
|
# GRAPHITI_DATABASE=auto_claude_memory
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: Miscellaneous Settings
|
|
# =============================================================================
|
|
|
|
# Disable Graphiti telemetry (default: true)
|
|
# GRAPHITI_TELEMETRY_ENABLED=false
|
|
|
|
# =============================================================================
|
|
# GRAPHITI: Example Configurations
|
|
# =============================================================================
|
|
#
|
|
# --- Example 1: OpenAI (simplest) ---
|
|
# GRAPHITI_ENABLED=true
|
|
# GRAPHITI_LLM_PROVIDER=openai
|
|
# GRAPHITI_EMBEDDER_PROVIDER=openai
|
|
# OPENAI_API_KEY=sk-xxxxxxxx
|
|
#
|
|
# --- Example 2: Anthropic + Voyage (high quality) ---
|
|
# GRAPHITI_ENABLED=true
|
|
# GRAPHITI_LLM_PROVIDER=anthropic
|
|
# GRAPHITI_EMBEDDER_PROVIDER=voyage
|
|
# ANTHROPIC_API_KEY=sk-ant-xxxxxxxx
|
|
# VOYAGE_API_KEY=pa-xxxxxxxx
|
|
#
|
|
# --- Example 3: Ollama (fully offline) ---
|
|
# GRAPHITI_ENABLED=true
|
|
# GRAPHITI_LLM_PROVIDER=ollama
|
|
# GRAPHITI_EMBEDDER_PROVIDER=ollama
|
|
# OLLAMA_LLM_MODEL=deepseek-r1:7b
|
|
# OLLAMA_EMBEDDING_MODEL=nomic-embed-text
|
|
# OLLAMA_EMBEDDING_DIM=768
|
|
#
|
|
# --- Example 4: Azure OpenAI (enterprise) ---
|
|
# GRAPHITI_ENABLED=true
|
|
# GRAPHITI_LLM_PROVIDER=azure_openai
|
|
# GRAPHITI_EMBEDDER_PROVIDER=azure_openai
|
|
# AZURE_OPENAI_API_KEY=xxxxxxxx
|
|
# AZURE_OPENAI_BASE_URL=https://your-resource.openai.azure.com/...
|
|
# AZURE_OPENAI_LLM_DEPLOYMENT=gpt-5
|
|
# AZURE_OPENAI_EMBEDDING_DEPLOYMENT=text-embedding-3-small
|