project-thoth/.env.example at main · acertainKnight/project-thoth · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
# Thoth Environment Variables
# Copy this to .env and fill in your values
# NEVER commit .env to git (it contains secrets)

# ============================================================================
# VAULT LOCATION (REQUIRED)
# ============================================================================
# Point to your Obsidian vault root directory
# This is the ONLY path you need to configure
OBSIDIAN_VAULT_PATH=/path/to/your/obsidian/vault

# Example:
# OBSIDIAN_VAULT_PATH=/Users/john/Documents/MyVault
# OBSIDIAN_VAULT_PATH=/home/user/Obsidian/ResearchVault

# ============================================================================
# API KEYS (Add only the ones you use)
# ============================================================================

# OpenAI (for GPT models)
OPENAI_API_KEY=sk-...

# Anthropic (for Claude models)
ANTHROPIC_API_KEY=sk-ant-...

# OpenRouter (unified API for multiple LLM providers)
OPENROUTER_API_KEY=sk-or-...

# Google (for Gemini models)
GOOGLE_API_KEY=...

# Groq (for fast inference)
GROQ_API_KEY=gsk_...

# ============================================================================
# WEB SEARCH (Optional)
# ============================================================================

# Serper (Google Search API)
SERPER_API_KEY=...

# Brave Search
BRAVE_API_KEY=...

# ============================================================================
# DATABASE (Optional - for persistent storage)
# ============================================================================

DATABASE_URL=postgresql://user:pass@localhost:5432/thoth

# ============================================================================
# MEMORY/LETTA (Optional - for agent memory)
# ============================================================================

# Letta Mode: 'cloud' or 'self-hosted' (default: self-hosted)
LETTA_MODE=self-hosted

# For self-hosted Letta:
LETTA_SERVER_URL=http://localhost:8283
LETTA_API_KEY=letta_dev_password  # Optional password for self-hosted

# For Letta Cloud:
# Option 1: Use OAuth (recommended) - run 'thoth letta auth login' first
# Option 2: Use API key from app.letta.com/api-keys
# LETTA_CLOUD_API_KEY=letta_sk_...

# Advanced: Custom OAuth credentials path (default: ~/.letta/credentials)
# LETTA_CREDENTIALS_PATH=~/.letta/credentials

# ============================================================================
# MULTI-USER MODE (optional - server deployments only)
# ============================================================================
# Enable to allow multiple users sharing one Thoth server.
# Each user gets an isolated vault under THOTH_VAULTS_ROOT and their own
# Letta agents. Requires a token (thoth_xxx) per user for API access.

# THOTH_MULTI_USER=false          # Set to 'true' to enable
# THOTH_VAULTS_ROOT=/vaults       # Host path for all user vaults (bind-mounted)
# THOTH_ALLOW_REGISTRATION=false  # Set to 'true' to allow self-registration

# ============================================================================
# NOTES:
# ============================================================================
# 1. All other settings are in vault_root/.thoth/settings.json
# 2. Settings sync across devices via Obsidian Sync automatically
# 3. Only OBSIDIAN_VAULT_PATH needs to be set per machine
# 4. API keys stay in .env (never synced, never committed)