.env.example

# VKRA Protocol Environment Variables
# Copy this file to .env and configure as needed

# =============================================================================
# Embedding Service Configuration
# =============================================================================

# Provider selection: "local" (Ollama) or "openai"
# Default: local
EMBED_PROVIDER=local

# Local Ollama Configuration (when EMBED_PROVIDER=local)
# Default: http://localhost:11434/api/embeddings
LOCAL_EMBED_URL=http://localhost:11434/api/embeddings

# Embedding model name for local Ollama
# Default: qwen3-embedding
# Example: qwen3-embedding, nomic-embed-text, etc.
EMBED_MODEL=qwen3-embedding

# OpenAI Configuration (when EMBED_PROVIDER=openai)
# Required if using OpenAI provider
OPENAI_API_KEY=your-openai-api-key-here

# OpenAI embedding model
# Default: text-embedding-3-small
# Options: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002
OPENAI_EMBED_MODEL=text-embedding-3-small

# =============================================================================
# LLM Service Configuration (for keyword extraction)
# =============================================================================

# Provider selection: "local" (Ollama) or "openai"
# Default: local
LLM_PROVIDER=local

# Local Ollama Configuration (when LLM_PROVIDER=local)
# Default: http://localhost:11434/api/chat
LOCAL_LLM_URL=http://localhost:11434/api/chat

# LLM model name for local Ollama
# Default: qwen3:8b
# Example: qwen3:8b, llama3:8b, mistral:7b, etc.
LLM_MODEL=qwen3:8b

# OpenAI LLM model (when LLM_PROVIDER=openai)
# Default: gpt-4o-mini
# Options: gpt-4o-mini, gpt-3.5-turbo, gpt-4, etc.
OPENAI_LLM_MODEL=gpt-4o-mini

# =============================================================================
# Quick Setup Guide
# =============================================================================
#
# For Local Setup (Default - Recommended for Open Source):
# 1. Install Ollama: https://ollama.ai
# 2. Pull the embedding model: ollama pull qwen3-embedding
# 3. Pull the LLM model: ollama pull qwen3:8b
# 4. No API keys needed - just use defaults!
#
# For OpenAI Setup:
# 1. Set EMBED_PROVIDER=openai
# 2. Set LLM_PROVIDER=openai
# 3. Set OPENAI_API_KEY=your-key-here
# 4. Optionally customize model names above
#
# =============================================================================