.env.example

# Required — your Anthropic API key
ANTHROPIC_API_KEY=sk-ant-...

# ── ComfyUI connection ────────────────────────────────────────────────────────
# COMFYUI_HOST=127.0.0.1
# COMFYUI_PORT=8188

# ── ComfyUI paths ─────────────────────────────────────────────────────────────
# Root directory containing Custom_Nodes/, models/, Workflows/ etc.
# Default: ~/ComfyUI  (cross-platform)
# COMFYUI_DATABASE=C:/Users/YourName/ComfyUI

# Where ComfyUI writes generated images.
# Default: <COMFYUI_DATABASE>/output
# COMFYUI_OUTPUT_DIR=C:/Users/YourName/ComfyUI/output

# ComfyUI application install directory (only needed when it differs from
# COMFYUI_DATABASE — e.g. app installed separately from your data folder).
# Default: <COMFYUI_DATABASE>
# COMFYUI_INSTALL_DIR=C:/AI/ComfyUI

# ── Agent model (CLI mode only) ───────────────────────────────────────────────
# Only affects `agent run`. MCP mode uses whatever model Claude Code selects.
# AGENT_MODEL=claude-opus-4-7
# For faster, cheaper CLI sessions:
# AGENT_MODEL=claude-sonnet-4-20250514
# (FAST_MODEL is defined for completeness but is currently inert at runtime.)

# ── LLM provider (swap the reasoning brain) ───────────────────────────────────
# Default: anthropic. Others: openai | gemini | ollama | nvidia | custom.
# Swap at launch with `agent run --model <alias>` / `--provider <name>`, or in
# conversation via the swap_model tool. See tooling/harness/PRD_model_swap.md.
# LLM_PROVIDER=anthropic

# ── NVIDIA / Nemotron (OpenAI-compatible) ─────────────────────────────────────
# Endpoint-agnostic — one provider serves all of these. Choose ONE endpoint and
# set AGENT_MODEL to a model id you've VERIFIED exists on it (do not guess ids).
#   NVIDIA NIM cloud:  NVIDIA_BASE_URL=https://integrate.api.nvidia.com/v1
#                      NVIDIA_API_KEY=nvapi-...
#   OpenRouter:        NVIDIA_BASE_URL=https://openrouter.ai/api/v1
#                      NVIDIA_API_KEY=<your OpenRouter key>   (or OPENROUTER_API_KEY)
#   self-hosted vLLM:  NVIDIA_BASE_URL=http://localhost:8000/v1   (key optional)
# LLM_PROVIDER=nvidia
# NVIDIA_BASE_URL=https://integrate.api.nvidia.com/v1
# NVIDIA_API_KEY=nvapi-...
# AGENT_MODEL=<verified-nemotron-id>
# NVIDIA_EMIT_REASONING=false   # true = request reasoning ON and show <think>
# OPENROUTER_API_KEY=
# Exploit a large Nemotron context window (e.g. ~1M). Opt-in — leaving it unset
# keeps COMPACT_THRESHOLD so a small self-hosted endpoint never overflows.
# NVIDIA_CONTEXT_WINDOW=900000
# COMPACT_THRESHOLD=120000      # tokens before context compaction (all providers)

# ── Custom engine (bring-your-own OpenAI-compatible endpoint) ─────────────────
# A distinct, honestly-named engine for a self-hosted / third-party endpoint
# (vLLM, SGLang, LM Studio, LiteLLM, OpenRouter, …) so a local endpoint isn't
# mislabeled "nvidia". Pick the endpoint via CUSTOM_BASE_URL; CUSTOM_MODEL selects
# the backend model; the key is optional for keyless local servers.
# LLM_PROVIDER=custom
# CUSTOM_BASE_URL=http://localhost:8000/v1
# CUSTOM_API_KEY=
# CUSTOM_MODEL=<your-backend-model-id>
# Where the last-selected model/provider is remembered across launches (optional).
# Default: ~/.comfy-cozy/model_selection.json
# MODEL_SELECTION_PATH=

# ── Vision provider (decoupled from the agent loop) ───────────────────────────
# analyze_image / compare_outputs need a MULTIMODAL provider. Swapping the agent
# loop to a text-only Nemotron does NOT move vision — it stays here. This means
# ANTHROPIC_API_KEY is STILL REQUIRED for vision even when LLM_PROVIDER=nvidia.
# VISION_PROVIDER=anthropic

# ── MCP auth ──────────────────────────────────────────────────────────────────
# Bearer token for the MCP HTTP/SSE transport (optional, unused in stdio mode).
# MCP_AUTH_TOKEN=

# ── Auto-initialization ───────────────────────────────────────────────────────
# Scan and index all models on agent startup (slow on first run).
# AUTO_SCAN_MODELS=false

# Scan and index all workflows on agent startup.
# AUTO_SCAN_WORKFLOWS=false

# Automatically load a workflow file when the agent starts (path or filename).
# AUTO_LOAD_WORKFLOW=

# Automatically resume a saved session on startup (session name or ID).
# AUTO_LOAD_SESSION=

# ── External service tokens ───────────────────────────────────────────────────
# CivitAI API key — required for authenticated downloads and higher rate limits.
# Get yours at: https://civitai.com/user/account
# CIVITAI_API_KEY=

# Hugging Face token — required for gated models (Flux, SD3, etc.).
# Get yours at: https://huggingface.co/settings/tokens
# HF_TOKEN=