.env.template

# GitPilot Environment Configuration
# Copy this file to .env and fill in your credentials
# These values will be used if not configured via the Admin UI

# =============================================================================
# GitHub Authentication
# =============================================================================

# Option 1: GitHub App (Recommended - Like Claude Code)
# Create your GitHub App at: https://github.com/settings/apps
# Users install the app to their repos, get automatic authentication
GITHUB_APP_ID=
GITHUB_APP_SLUG=gitpilot
# Note: GitHub App slug is used for installation URL (https://github.com/apps/{slug})

# Option 2: Personal Access Token (PAT) - Quickstart
# Get yours at: https://github.com/settings/tokens/new?scopes=repo,user:email
# This is the simplest way to get started immediately
GITPILOT_GITHUB_TOKEN=

# Alternative PAT variable name (either works)
# GITHUB_TOKEN=

# Option 3: OAuth App (Advanced — "Continue with GitHub" Web Flow)
# Create OAuth App at: https://github.com/settings/developers
# NOTE: The Web Flow only activates when GITHUB_CLIENT_SECRET is set. Without it
# the app automatically uses the Device Flow (no secret / no callback URL).
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
# Browser callback after authorizing on GitHub. This must point at the FRONTEND
# /auth page (which exchanges the code), NOT the API. When left blank it
# defaults to "{GITPILOT_PUBLIC_BASE_URL}/auth". Register this exact URL as the
# OAuth/GitHub App "Authorization callback URL".
#   Local dev:  http://localhost:5173/auth
#   Production: https://gitpilot.ruslanmv.com/auth
GITHUB_REDIRECT_URI=

# Priority: GitHub App > OAuth > PAT
# For quickstart: Use PAT
# For Claude Code behavior: Use GitHub App
# For enterprise SSO: Use OAuth

# =============================================================================
# LLM Provider Selection
# =============================================================================
# Choose your default provider: openai, claude, watsonx, ollama
GITPILOT_PROVIDER=openai

# =============================================================================
# OpenAI Configuration
# =============================================================================
# Get your API key at: https://platform.openai.com/api-keys
OPENAI_API_KEY=

# Optional: Override default model (default: gpt-4o-mini)
GITPILOT_OPENAI_MODEL=gpt-4o-mini

# Optional: Custom base URL (for Azure OpenAI or API proxies)
# OPENAI_BASE_URL=

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

# Optional: Override default model (default: claude-sonnet-4-5)
GITPILOT_CLAUDE_MODEL=claude-sonnet-4-5

# Optional: Custom base URL (for API proxies)
# ANTHROPIC_BASE_URL=

# =============================================================================
# IBM Watsonx.ai Configuration
# =============================================================================
# Get your credentials at: https://cloud.ibm.com/
WATSONX_API_KEY=
WATSONX_PROJECT_ID=

# Optional: Override default model (default: meta-llama/llama-3-3-70b-instruct)
GITPILOT_WATSONX_MODEL=meta-llama/llama-3-3-70b-instruct

# Optional: Override default base URL (default: https://api.watsonx.ai/v1)
# WATSONX_BASE_URL=https://api.watsonx.ai/v1

# =============================================================================
# Ollama Configuration (Local LLMs)
# =============================================================================
# Ollama base URL (default: http://localhost:11434)
OLLAMA_BASE_URL=http://localhost:11434

# Model to use with Ollama (default: llama3)
GITPILOT_OLLAMA_MODEL=llama3

# =============================================================================
# OllaBridge / OllaBridge Cloud Configuration
# =============================================================================
# OllaBridge base URL (default: http://localhost:8000)
# OLLABRIDGE_BASE_URL=http://localhost:8000

# Model to use with OllaBridge (default: qwen2.5:1.5b)
# GITPILOT_OLLABRIDGE_MODEL=qwen2.5:1.5b

# Optional: API key for authenticated endpoints
# OLLABRIDGE_API_KEY=

# =============================================================================
# Lite Mode (Optional — for small LLMs under 7B parameters)
# =============================================================================
# Enable Lite Mode to use simplified prompts and single-agent execution.
# Recommended when using small models like qwen2.5:1.5b, phi-3-mini, gemma-2b.
# Default: false — standard multi-agent pipelines are used.
# GITPILOT_LITE_MODE=false

# =============================================================================
# LangFlow Integration (Optional)
# =============================================================================
# LangFlow server URL
# GITPILOT_LANGFLOW_URL=http://localhost:7860

# LangFlow API key
# GITPILOT_LANGFLOW_API_KEY=

# LangFlow plan flow ID
# GITPILOT_LANGFLOW_PLAN_FLOW_ID=

# =============================================================================
# Server Configuration
# =============================================================================
# Host to bind the server (default: 127.0.0.1)
# GITPILOT_HOST=127.0.0.1

# Port to run the server (default: 8000)
# GITPILOT_PORT=8000

# Enable debug mode (default: false)
# GITPILOT_DEBUG=false

# =============================================================================
# Notes
# =============================================================================
# 1. You only need to configure the provider you plan to use
# 2. Environment variables take precedence over Admin UI settings
# 3. Admin UI settings are stored in ~/.gitpilot/settings.json
# 4. For production, use environment variables or secret management
# 5. Never commit this file with real credentials!

# =============================================================================
# MCP Context Forge plugin (gitpilot.mcp_plugin)
# =============================================================================
# Wires GitPilot's agents to the postgre / milvus / inspector MCP servers
# through one MCP Context Forge gateway. Falls back to no-op when disabled.

GITPILOT_MCP_ENABLED=false
GITPILOT_MCP_GATEWAY_URL=http://mcp-context-forge:4444/mcp
GITPILOT_MCP_AUTH_TOKEN=change-me
GITPILOT_MCP_ALLOWED_SERVERS=mcp-postgre-server,mcp-milvus-server,mcp-inspector-server
GITPILOT_MCP_ENABLE_DURING_CODE_GENERATION=true
GITPILOT_MCP_ENABLE_DURING_TEST_GENERATION=true
GITPILOT_MCP_REQUIRE_APPROVAL_FOR_MUTATIONS=true
GITPILOT_MCP_MAX_CALLS_PER_REQUEST=20
GITPILOT_MCP_TIMEOUT_SECONDS=30

# =============================================================================
# GitPilot Repair Flow (generic patch generation via OllaBridge)
# =============================================================================
# GitPilot is the ONLY component that GENERATES patches. It is GENERIC and
# provider-neutral: it calls OllaBridge (or any OpenAI-compatible endpoint)
# via OPENAI_BASE_URL + OPENAI_API_KEY. It NEVER reads HF_TOKEN.

# Caller identity (Agent-Matrix is just a default client_id, not hardcoded).
GITPILOT_CLIENT_ID=agent-matrix
GITPILOT_WORKSPACE_ID=default

# OpenAI-compatible endpoint (OllaBridge). Key format: ob_test_xxx / ob_live_xxx
OPENAI_BASE_URL=http://localhost:11434
OPENAI_API_KEY=ob_test_changeme

# Model aliases served by OllaBridge.
GITPILOT_MODEL_FAST=code-fast
GITPILOT_MODEL_CODER=code-coder
GITPILOT_MODEL_REVIEWER=code-reviewer

# Sandbox (MatrixLab) for patch validation.
GITPILOT_SANDBOX_PROVIDER=matrixlab
MATRIXLAB_URL=http://localhost:8765
MATRIXLAB_TOKEN=change-me

# Safety: draft PRs are a no-op stub in the first wave; demo mode runs offline.
GITPILOT_DRAFT_PR_ENABLED=false
GITPILOT_DEMO_MODE=true