.env.example

# Mini-Agent Configuration
# Copy to .env and fill in your values

# Required: Instance ID (any short string)
MINI_AGENT_INSTANCE=my-agent

# Required: HTTP server port
PORT=3001

# Optional: Telegram notifications
# TELEGRAM_BOT_TOKEN=
# TELEGRAM_CHAT_ID=

# Optional: API authentication
# MINI_AGENT_API_KEY=

# Agent-owned service/account/server/API/relationship registry.
# Secret values stay in .env or an OS secret store. The registry only names
# expected identities and credential env vars. Every new service, server, API,
# public account, API key, related AI, related human, and associated external
# account Kuro uses must be declared in this registry first.
# Use path-delimited entries to layer private/local capability overlays on top
# of config/agent-capabilities.json.
# KURO_AGENT_CAPABILITIES_PATH=config/agent-capabilities.json
# KURO_GITHUB_LOGIN=kuro-agent
# KURO_GITHUB_TOKEN=
# KURO_GOOGLE_EMAIL=kuro.ai.agent@gmail.com
# GMAIL_APP_PASSWORD=
# KURO_DEVTO_USERNAME=kuro_agent
# DEV_TO_API_KEY=
# KURO_MASTODON_HANDLE=kuro_agent@mastodon.social
# MASTODON_ACCESS_TOKEN=
# KG_BASE_URL=
# KG_API_KEY=

# Optional: external memory/state workspace.
# Recommended for production runtime: keeps /Users/user/Workspace/mini-agent as
# clean runtime/main while Kuro's file-truth memory writes land elsewhere.
# MINI_AGENT_MEMORY_DIR=/Users/user/Workspace/mini-agent-memory/memory

# Optional: Chrome CDP for web access
# CDP_PORT=9222

# Optional: LLM Provider — claude | codex | local (OpenAI-compatible API)
# AGENT_PROVIDER=claude
# AGENT_FALLBACK=codex

# Optional: Local LLM server (for 'local' provider — oMLX, ollama, vLLM, etc.)
# Per-profile url/key/model in llm/profiles/*.json take precedence over these env vars
# LOCAL_LLM_URL=http://localhost:8000
# LOCAL_LLM_KEY=local
# LOCAL_LLM_MODEL=Qwen3.5-9B-MLX-4bit  # fallback model when profile doesn't specify one

# Layer C: route cycle LLM call through middleware (agent-brain worker)
# Solves event-loop blocking — main thread never iterates SDK subprocess stdout.
# Middleware must be running on MIDDLEWARE_URL (default localhost:3200).
# USE_MIDDLEWARE_FOR_CYCLE=true

# Optional: route delegations through BrainRuntime multi-brain arbitration.
# Requires middleware workers for the default adapter set.
# MINI_AGENT_DELEGATION_RUNTIME=true
# AKARI_MIDDLEWARE_WORKER=cloud-agent
# TANREN_MIDDLEWARE_WORKER=