openspace/.env.example

# ============================================
# OpenSpace Environment Variables
# Copy this file to .env and fill in your keys
# ============================================

# ---- LLM API Keys ----
# At least one LLM API key is required for OpenSpace to function.
# OpenSpace uses LiteLLM for model routing, so the key you need depends on your chosen model.
# See https://docs.litellm.ai/docs/providers for supported providers.

# Anthropic (for anthropic/claude-* models)
# ANTHROPIC_API_KEY=

# OpenAI (for openai/gpt-* models)
# OPENAI_API_KEY=

# OpenRouter (for openrouter/* models, e.g. openrouter/anthropic/claude-sonnet-4.5)
OPENROUTER_API_KEY=

# ── OpenSpace Cloud (optional) ──────────────────────────────
# Register at https://open-space.cloud to get your key.
# Enables cloud skill search & upload; local features work without it.

OPENSPACE_API_KEY=sk_xxxxxxxxxxxxxxxx

# ---- GUI Backend (Anthropic Computer Use) ----
# Required only if using the GUI backend. Uses the same ANTHROPIC_API_KEY above.
# Optional backup key for rate limit fallback:
# ANTHROPIC_API_KEY_BACKUP=

# ---- Web Backend (Deep Research) ----
# Required only if using the Web backend for deep research.
# Uses OpenRouter API by default:
# OPENROUTER_API_KEY=

# ---- Embedding (Optional) ----
# For remote embedding API instead of local model.
# If not set, OpenSpace uses a local embedding model (BAAI/bge-small-en-v1.5).
# EMBEDDING_BASE_URL=
# EMBEDDING_API_KEY=
# EMBEDDING_MODEL= "openai/text-embedding-3-small"

# ---- E2B Sandbox (Optional) ----
# Required only if sandbox mode is enabled in security config.
# E2B_API_KEY=

# ---- Local Server (Optional) ----
# Override the default local server URL (default: http://127.0.0.1:5000)
# Useful for remote VM integration (e.g., OSWorld).
# LOCAL_SERVER_URL=http://127.0.0.1:5000

# ---- Debug (Optional) ----
# OPENSPACE_DEBUG=true