Environment Setup

cd RepoMaster
cp configs/env.example configs/.env

nano configs/.env
# or
vim configs/.env
# or
code configs/.env

python launcher.py --mode backend --backend-mode unified

# ==============================================================================
# RepoMaster Environment Configuration Example
# ==============================================================================
# Copy this file to .env and fill in your actual API keys and configurations

# ==============================================================================
# Default API Provider Configuration
# ==============================================================================
# Set the default API provider (openai, claude, deepseek, azure_openai)
# If not set, will use the first available provider in priority order
DEFAULT_API_PROVIDER=openai

# ==============================================================================
# Search Engine APIs
# Get your API key at: https://serper.dev/login
SERPER_API_KEY=${SERPER_API_KEY}

# Jina AI (for document processing)
# Get your API key at: https://jina.ai/
JINA_API_KEY=${JINA_API_KEY}


# ==============================================================================
# LLM Provider API Keys
# ==============================================================================

# OpenAI Configuration
OPENAI_API_KEY=${OPENAI_API_KEY}
OPENAI_MODEL=gpt-5
OPENAI_BASE_URL=https://api.openai.com/v1

# Anthropic Claude Configuration
ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
ANTHROPIC_MODEL=claude-4-sonnet

# DeepSeek Configuration
DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
DEEPSEEK_MODEL=deepseek-v3
DEEPSEEK_BASE_URL=https://api.deepseek.com/v1

# Google Gemini Configuration
GEMINI_API_KEY=${GEMINI_API_KEY}
GEMINI_MODEL=gemini-2.5-pro

# Serper API - Google search results
SERPER_API_KEY=your_serper_api_key

# Jina AI - Document processing and web content extraction
JINA_API_KEY=your_jina_api_key

AZURE_OPENAI_API_KEY=your_azure_key
AZURE_OPENAI_MODEL=gpt-4o
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
AZURE_OPENAI_API_VERSION=2024-02-15-preview

# OpenAI-compatible endpoint
OPENAI_BASE_URL=https://your-custom-endpoint.com/v1

# Custom Claude endpoint
ANTHROPIC_BASE_URL=https://your-custom-endpoint.com

# Custom DeepSeek endpoint
DEEPSEEK_BASE_URL=https://your-custom-endpoint.com/v1

# Adds RepoMaster directory to Python path
current_dir = Path(__file__).parent.absolute()
os.environ['PYTHONPATH'] = f"{current_dir}:{python_path}"

env_file = current_dir / "configs" / ".env"
env_example_file = current_dir / "configs" / "env.example"

required_keys = ['SERPER_API_KEY', 'JINA_API_KEY']
# At least one LLM provider key also required

✅ Using API provider 'openai' with valid configuration

⚠️  Configuration file not found!
📝 Please copy the example configuration file:
   cp configs/env.example configs/.env
   Then edit configs/.env with your API keys
💡 See README.md or USAGE.md for detailed setup instructions

⚠️  Missing required API keys in .env file: SERPER_API_KEY, JINA_API_KEY
📝 Please edit configs/.env and add the missing keys
💡 See README.md or USAGE.md for API key setup instructions

❌ No valid API provider found. Please configure at least one API key.

import os

# Get API key
api_key = os.environ.get("OPENAI_API_KEY")

# Get with default value
model = os.environ.get("OPENAI_MODEL", "gpt-4o")

# Get default provider
default_provider = os.environ.get("DEFAULT_API_PROVIDER", "openai")

from configs.oai_config import get_api_config, get_default_provider

# Get default provider
provider = get_default_provider()  # Returns: openai, claude, deepseek, etc.

# Get all API configurations
configs = get_api_config()

# Environment files
configs/.env
.env
*.env

# Development
cp configs/env.example configs/.env.dev

# Production  
cp configs/env.example configs/.env.prod

# Load specific environment
export ENV_FILE=configs/.env.prod
python launcher.py

# 1. Verify file location
ls -la configs/.env

# 2. Check file format (no spaces around =)
# Wrong:  OPENAI_API_KEY = sk-...
# Correct: OPENAI_API_KEY=sk-...

# 3. Reload environment
source configs/.env  # Not needed, but helps verify syntax

chmod 600 configs/.env  # Owner read/write only

# Wrong (in .env):
OPENAI_API_KEY=${OPENAI_API_KEY}

# Correct (in .env):
OPENAI_API_KEY=sk-proj-abc123...