.env.example

# VisionEngine Configuration
# Copy to .env and fill in your API keys

# ─── Vision Provider Selection ──────────────────────────────
# Options: auto, astica, openai, anthropic, gemini, qwen, kimi, stepgui, ollama
# "auto" probes all configured providers and selects the best available.
HELIX_VISION_PROVIDER=auto

# ─── Astica.AI Vision ──────────────────────────────────────
# Specialized computer vision API (high quality UI analysis)
ASTICA_API_KEY=YOUR_ASTICA_API_KEY_HERE

# ─── Cloud Vision API Keys ─────────────────────────────────
OPENAI_API_KEY=YOUR_OPENAI_KEY_HERE
ANTHROPIC_API_KEY=YOUR_ANTHROPIC_KEY_HERE
GOOGLE_API_KEY=YOUR_GEMINI_KEY_HERE
NVIDIA_API_KEY=YOUR_NVIDIA_KEY_HERE
QWEN_API_KEY=YOUR_QWEN_KEY_HERE
KIMI_API_KEY=YOUR_KIMI_KEY_HERE
# MOONSHOT_API_KEY=...  # Alternative to KIMI_API_KEY
STEPFUN_API_KEY=YOUR_STEPFUN_KEY_HERE

# ─── Provider-specific Models (optional, defaults used if unset) ──
# HELIX_VISION_OPENAI_MODEL=gpt-4o
# HELIX_VISION_ANTHROPIC_MODEL=claude-sonnet-4-20250514
# HELIX_VISION_GEMINI_MODEL=gemini-2.0-flash
# HELIX_VISION_QWEN_MODEL=qwen-vl-max
# HELIX_VISION_KIMI_MODEL=kimi-k2.5
# HELIX_VISION_STEPGUI_MODEL=step-1.5v-mini

# ─── OpenCV Features ───────────────────────────────────────
HELIX_VISION_OPENCV_ENABLED=true
HELIX_VISION_SSIM_THRESHOLD=0.95
HELIX_VISION_MAX_IMAGE_SIZE=4096

# ─── Timeout ───────────────────────────────────────────────
HELIX_VISION_TIMEOUT=60

# ─── Local Vision (Ollama) ─────────────────────────────────
# URL to Ollama API for local/remote vision inference.
# Used as a free, no-rate-limit alternative to cloud providers.
HELIX_OLLAMA_URL=http://thinker.local:11434
HELIX_OLLAMA_MODEL=minicpm-v:8b

# ─── Multi-Host Distributed Vision ─────────────────────────
# Comma-separated list of hosts for distributed inference.
# Each host runs Ollama or llama.cpp.
HELIX_VISION_HOSTS=thinker.local,amber.local
HELIX_VISION_USER=milosvasic

# ─── Distributed llama.cpp RPC ──────────────────────────────
# Split large models across multiple hosts using llama.cpp
# RPC protocol. Requires llama.cpp built with -DGGML_RPC=ON.
HELIX_LLAMACPP_RPC_ENABLED=false
HELIX_LLAMACPP_RPC_WORKERS=
HELIX_LLAMACPP_RPC_MODEL=~/models/vision-model.gguf