Krab/.env.example at main · OpenKrab/Krab · 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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
# ============================================
# 🦀 Krab — AI Agent Framework Configuration
# ============================================
# Copy this file to .env and fill in your keys
# cp .env.example .env

# === LLM Provider (choose at least 1) ===

# Google Gemini (FREE — recommended for getting started)
# Get your key at: https://aistudio.google.com
GEMINI_API_KEY=

# OpenAI (paid)
# Get your key at: https://platform.openai.com/api-keys
OPENAI_API_KEY=

# Anthropic Claude (paid)
# Get your key at: https://console.anthropic.com
ANTHROPIC_API_KEY=

# DeepSeek (cheap)
# Get your key at: https://platform.deepseek.com
DEEPSEEK_API_KEY=

# OpenRouter (aggregates 100+ models)
# Base URL: https://openrouter.ai/api/v1
# Get your key at: https://openrouter.ai
OPENROUTER_API_KEY=

# Kilocode (OpenAI-compatible gateway, supports many models)
# Base URL: https://api.kilo.ai/api/gateway/
# Get your key at: https://kilo.ai
KILOCODE_API_KEY=

# OpenCode Zen (pay-as-you-go coding agent API)
# Base URL: https://opencode.ai/zen/v1
# Auth URL: https://opencode.ai/auth
# Models: Claude Opus 4.6, GPT-5.2, Gemini 3 Pro, GLM-4.7 (free), etc.
OPENCODE_API_KEY=

# Ollama (FREE — local, no key needed)
# Install from: https://ollama.com
OLLAMA_BASE_URL=http://localhost:11434

# === Default Model ===
# Format: provider/model-name
#
# 🆓 FREE models available:
#   openrouter/google/gemini-2.0-flash    — Gemini 2.0 Flash (OpenRouter, free)
#   openrouter/google/gemma-3-27b-it     — Gemma 3 27B (OpenRouter, free)
#   openrouter/meta-llama/llama-3.3-70b-instruct — Llama 3.3 70B (OpenRouter, free)
#   openrouter/qwen/qwen3-coder         — Qwen3 Coder (OpenRouter, free)
#   openrouter/stepfun/step-3.5-flash:free — Step-3.5 Flash (OpenRouter, free)
#   openrouter/openrouter/free          — Auto-select best free model
#   kilocode/z-ai/glm-5:free          — GLM-5 (Kilocode, free)
#   kilocode/minimax/minimax-m2.5:free — MiniMax M2.5 (Kilocode, free)
#   opencode/glm-4.7                  — GLM-4.7 (OpenCode Zen, free)
#   gemini/gemini-2.0-flash            — Gemini 2.0 Flash (Google, free tier)
#   ollama/llama3                      — Llama 3 (Local, free)
#
# 💰 Paid models:
#   kilocode/anthropic/claude-opus-4.6, opencode/claude-opus-4-6, openai/gpt-4o, etc.
#
KRAB_DEFAULT_MODEL=kilocode/z-ai/glm-5:free

# === Agent Settings ===
KRAB_AGENT_NAME=Krab
KRAB_MAX_TOOL_ROUNDS=10
KRAB_ENABLE_REFLECTION=true
KRAB_ENABLE_PLANNING=true

# === Memory ===
KRAB_MEMORY_DB_PATH=./data/memory.db
KRAB_ENABLE_LONG_TERM_MEMORY=true

# === Web Search (Perplexity-Style) ===
# Multiple search providers for best results

# Bing Search API (free tier: 1000 queries/month)
# Get your key at: https://www.microsoft.com/en-us/bing/apis/bing-web-search-api
BING_API_KEY=

# Brave Search API (free tier: 2000 queries/month)
# Get your key at: https://api.search.brave.com/
BRAVE_API_KEY=

# Tavily (AI-powered search results)
# Get your key at: https://tavily.com (free tier: 1000 searches/month)
TAVILY_API_KEY=

# If no API keys are set, Krab will use DuckDuckGo as a free fallback

# === Knowledge Base (Obsidian Integration) ===
# Absolute path to your Obsidian vault
# The agent can read, write, search, and analyze your notes
OBSIDIAN_VAULT_PATH=

# === Messaging Channels (Phase 3) ===

# Telegram Bot
# Create a bot via @BotFather on Telegram
TELEGRAM_BOT_TOKEN=

# LINE Bot
# Get from: https://developers.line.biz
LINE_CHANNEL_ACCESS_TOKEN=
LINE_CHANNEL_SECRET=

# === Server (for webhook channels) ===
KRAB_PORT=3000
KRAB_HOST=0.0.0.0