.env.example

# Postgres connection (asyncpg). Query params like ?schema= are stripped.
DATABASE_URL=postgresql://quantumbyte:quantumbyte@localhost:5432/quantumbyte

# Optional. Leave blank or as the sk-ant-... placeholder to fall back to the
# claude.ai login credentials at ~/.claude/.credentials.json. Only a real-looking
# key (length > 20, no "...") is passed through to the SDK subprocess.
ANTHROPIC_API_KEY=sk-ant-...

# GitHub PAT (classic or fine-grained with `repo` scope). Used to create each
# project's private repo and clone it locally. The repo owner is derived from
# the token — no username needed. Required for the agent workspace.
GIT_PAT=

# Root dir holding every project's local clone: <LOCAL_STORAGE>/qb-<project_id>.
LOCAL_STORAGE=/var/qb-workspaces

# Git identity stamped on commits the agent makes in each project repo.
GIT_AUTHOR_NAME=QuantumByte
GIT_AUTHOR_EMAIL=agent@quantumbyte.local

# Redis — lock store for the harness per-project run lock (redis_lock.py). NOT a
# broker; coordination still flows through Postgres. The worker degrades open
# (runs without the dedup lock) if Redis is unreachable. Matches the redis service
# in docker-compose.yml.
REDIS_URL=redis://localhost:6379/0

# Skills (P3). SKILLS_PLUGIN_DIR is where the skills plugin is (re)built each
# session open — a stable path outside the repo and any project clone; defaults
# to <tempdir>/qb-skills-plugin.
# SKILLS_PLUGIN_DIR=

# Prompt source tree. Defaults to apps/worker/shared/prompts. Override to a
# mounted volume when the prompts live outside the image.
# PROMPTS_ROOT=

# App preview runner (preview.py). Install step timeout; dir for preview logs.
PREVIEW_INSTALL_TIMEOUT_SECONDS=600
PREVIEW_LOG_DIR=/tmp/quantumbyte-preview

# S3 / minio (P4) — asset storage for the qb-designer tools. Matches the minio
# service in docker-compose.yml. S3_PUBLIC_URL is the browser-reachable base
# (asset URL = <S3_PUBLIC_URL>/<S3_BUCKET>/<key>); keep it distinct from the
# internal S3_ENDPOINT when the worker runs in-cluster.
S3_ENDPOINT=http://localhost:9000
S3_PUBLIC_URL=http://localhost:9000
S3_ACCESS_KEY=quantumbyte
S3_SECRET_KEY=quantumbyte
S3_BUCKET=qb-assets

# Gemini image generation (P4) — the generate_image designer tool.
GEMINI_API_KEY=
GEMINI_IMAGE_GEN_MODEL=gemini-3.1-flash-image-preview

# Advisory per-turn budget (hooks). Seconds; 0 disables that dimension. Token
# budget defaults off — time is the runaway guard.
AGENT_TURN_TOKEN_BUDGET=0
AGENT_PARTNER_TIME_BUDGET_SECONDS=300

# Optional tuning.
HEARTBEAT_SECONDS=5
POLL_INTERVAL_SECONDS=1

# Turn lease (seconds): a claimed turn whose lease expires is reclaimable by
# another worker — the crash-recovery guard.
LEASE_SECONDS=120

# How long a project stays pinned to this worker after going idle (affinity).
# Must match the orchestrator's AFFINITY_TTL_SECONDS.
AFFINITY_TTL_SECONDS=1800

# Optional. Defaults to "<hostname>-<pid>", unique per running process.
# WORKER_ID=