# TachiBot MCP v2.0 - Configuration # Copy this file to .env and add your API keys # =================================== # Profile Selection # =================================== # Choose your tool profile (controls which tools are loaded) # Options: minimal, research_power, code_focus, balanced, full # Default: balanced (if not specified) # See TOOL_PROFILES.md for details TACHIBOT_PROFILE=balanced # =================================== # Output Rendering # =================================== # How tool outputs should be rendered # Options: # markdown - Raw markdown, no processing (default, ~1x tokens) # ink - React Ink with themes, gradients, tables (~12x tokens) # ansi - Legacy marked-terminal rendering # plain - Stripped plain text RENDER_OUTPUT=markdown # Terminal theme for ANSI output # Options: # nebula - Modern SaaS look, soft pastels (default) # cyberpunk - High contrast neon, Blade Runner vibes # minimal - Swiss typography, mostly monochrome # ocean - Cool blues and teals, calm professional TACHIBOT_THEME=nebula # =================================== # Required API Keys # =================================== # Get your API keys from: # - Perplexity: https://www.perplexity.ai/settings/api # - Grok/xAI: https://console.x.ai/ # - OpenAI: https://platform.openai.com/api-keys # - Google Gemini: https://aistudio.google.com/apikey # Perplexity API (for web search, research, reasoning) PERPLEXITY_API_KEY= # Grok/xAI API (for code analysis, debugging, architecture) # Get from: https://console.x.ai/ XAI_API_KEY= # Legacy alias (both work): # GROK_API_KEY= # OpenAI API (for GPT-5, analysis, comparison) OPENAI_API_KEY= # =================================== # Optional API Keys # =================================== # Google Gemini API (for brainstorming, code/text analysis) GOOGLE_API_KEY= # OpenRouter API (for Qwen3 Coder, Kimi, and gateway mode) OPENROUTER_API_KEY= # =================================== # OpenRouter Gateway Mode (Optional) # =================================== # When enabled, routes OpenAI/Gemini/Grok through OpenRouter # Benefits: Single API key, unified billing, automatic fallbacks # Note: Kimi/Qwen always use OpenRouter, Perplexity always uses direct API USE_OPENROUTER_GATEWAY=false # Anthropic API (optional - not currently used in Claude Code mode) # ANTHROPIC_API_KEY= # Qwen API (for Qwen Max model) QWEN_API_KEY= # =================================== # Memory System (Optional) # =================================== # Supabase configuration for persistent memory storage SUPABASE_URL= SUPABASE_SERVICE_KEY= # =================================== # Performance Settings # =================================== # Note: TachiBot does not track API costs internally # Monitor your usage through each provider's dashboard # =================================== # Timeout Configuration # =================================== # IMPORTANT: Adjust these if you experience timeout errors # Multi-model operations (verifier, challenger) can take 60-180s # Complex workflows can take 5-10 minutes # Global default timeout for all operations (milliseconds) # Default: 90000 (90 seconds) TACHI_DEFAULT_TIMEOUT=90000 # Per-tool timeout overrides (milliseconds) # Verifier: Multi-model parallel verification (default: 120000 = 2 min) TACHI_VERIFIER_TIMEOUT=120000 # Challenger: Critical analysis with fact-checking (default: 180000 = 3 min) TACHI_CHALLENGER_TIMEOUT=180000 # Scout: Information gathering with live search (default: 180000 = 3 min) TACHI_SCOUT_TIMEOUT=180000 # Focus: Deep reasoning and collaborative sessions (default: 300000 = 5 min) TACHI_FOCUS_TIMEOUT=300000 # Workflow: Complex multi-step workflows (default: 300000 = 5 min) TACHI_WORKFLOW_TIMEOUT=300000 # PingPong: Multi-round conversations (default: 600000 = 10 min) TACHI_PINGPONG_TIMEOUT=600000 # Individual API call timeout (default: 60000 = 1 min) # This is PER API call, not total operation time TACHI_API_TIMEOUT=60000 # Show progress for operations exceeding this duration (default: 30000 = 30s) TACHI_PROGRESS_THRESHOLD=30000 # =================================== # Workflow Configuration # =================================== # Max ping-pong brainstorm rounds (default: 24) # Higher values = deeper reasoning but more cost MAX_PINGPONG_ROUNDS=24 # Max reasoning rounds for collaborative sessions (1-10) MAX_REASONING_ROUNDS=5 # =================================== # Search & Research Configuration # =================================== # Default search provider for scout/research (perplexity, grok, both) DEFAULT_SEARCH_PROVIDER=perplexity # Enable Grok-4 live search in scout mode (costs extra per 1k sources) ENABLE_GROK_LIVE_SEARCH=false # Max sources for Grok live search (default: 100, lower = cheaper) GROK_SEARCH_SOURCES_LIMIT=100 # =================================== # Optional Settings # =================================== # Enable visual ASCII art in output ENABLE_VISUALS=true # Enable debug logging DEBUG=false # Default technical domain for brainstorming # Options: architecture, algorithms, debugging, security, # performance, api_design, database, frontend, # backend, devops, testing DEFAULT_DOMAIN= # ============================================================================ # OUTPUT DIRECTORY CONFIGURATION # ============================================================================ # All workflow and session outputs go to workflow-output/ by default # Override these to customize output locations # Base directory for all workflow outputs (workflows/*.yaml execution results) # Default: ./workflow-output # WORKFLOW_OUTPUT_DIR=./workflow-output # Directory for session logs (focus/pingpong tool outputs) # Default: ./workflow-output/sessions # SESSION_OUTPUT_DIR=./workflow-output/sessions # ============================================================================ # SESSION CONFIGURATION # ============================================================================ # Controls session logging behavior for focus and pingpong tools # Enable session logging (saves markdown/json/html logs) # Default: true # ENABLE_SESSION_LOGGING=true # Automatically save sessions after completion # Default: false # SESSION_AUTO_SAVE=false # Show verbose output during session execution # Default: false # SESSION_DEFAULT_VERBOSE=false # Output format for session logs # Options: markdown, json, html # Default: markdown # SESSION_DEFAULT_FORMAT=markdown # Include metadata (tokens, timing, models) in session logs # Default: true # SESSION_INCLUDE_METADATA=true # Maximum number of session history entries to keep # Default: 100 # SESSION_MAX_HISTORY=100 # =================================== # Local Model Configuration (Optional) # =================================== # Configure local model endpoints if you run your own models # LMStudio endpoint LMSTUDIO_BASE_URL= # Ollama endpoint OLLAMA_BASE_URL= # =================================== # Advanced: Model-Specific Overrides # =================================== # Only change these if you need fine-grained control # Enable GPT-5 models (requires OpenAI API key) ENABLE_GPT5=false # Enable competitive Qwen mode (enables multi-model parallel reasoning) ENABLE_QWEN_COMPETITIVE=false # Enable expensive models (currently only grok_heavy - 256k context) ENABLE_EXPENSIVE_MODELS=false # Grok Configuration ENABLE_GROK_HEAVY=false GROK_MAX_TOKENS=100000 GROK_COST_LIMIT=1.0 # Model priority (lower = higher priority) GROK_PRIORITY=2 # =================================== # Advanced: Tool-Specific Overrides # =================================== # Force enable/disable specific tools regardless of profile # Example: ENABLE_TOOL_PINGPONG=true # Example: DISABLE_TOOL_GROK_SEARCH=false # =================================== # Model Selection (Multi-Model Tools) # =================================== # Configure which models are used for Scout, Challenger, and Verifier # These tools run multiple models in parallel for consensus/verification # Comma-separated list of model names (no spaces) # Scout model configuration # quick_scout: Fast checks, cost-efficient (default: qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini) SCOUT_QUICK_MODELS=qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini # research_scout: Thorough research (default: qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini) SCOUT_RESEARCH_MODELS=qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini # Challenger model configuration # Used for critical analysis and counter-arguments (default: qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini) CHALLENGER_MODELS=qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini # Verifier model configuration # quick_verify: Fast verification (default: qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini) VERIFIER_QUICK_MODELS=qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini # standard modes (fact_check, code_verify, security_verify): Balance quality & cost (default: qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini) VERIFIER_STANDARD_MODELS=qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini # deep_verify: Maximum quality for critical verification (default: qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5) VERIFIER_DEEP_MODELS=qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5 # Default models for fallback (default: qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini) DEFAULT_MODELS=qwen/qwen3-coder-plus,gemini-3.1-pro-preview,gpt-5-mini # =================================== # Model Selection Tips # =================================== # gpt-5-mini vs gpt-5: # - gpt-5-mini: Faster, good for most tasks # - gpt-5: Full quality, best for critical decisions # # gemini-3.1-pro-preview vs gemini-3.1-pro-preview: # - flash: Faster, good for quick checks # - pro: Better reasoning, accuracy, recommended for verification tasks # # Recommendation: Use defaults (gpt-5-mini + flash) for speed and lower costs.