mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
Renn F
fd4df51572
A documentation audit against the code surfaced several stale claims: - Agent count: the roster is 19 AI agents (the UX/UI cell has two devs, ux-dev-1 + ux-dev-2), not 18 / a single UX dev. Fixed in README, CLAUDE.md, base.md, and docs/ux_ui. - API: domain routes are mounted under /api, not /api/v1 (the /api/v1 prefix is the agent gateway only); dropped the non-existent /api/v1/test group; fixed the orchestrator-status path in deployment.md. - Quick Start uvicorn target is roboco.api.app:app (the api package deliberately does not export app). - Verb table: the developer PR verb is open_pr (renamed from submit_for_qa); the lifecycle's canonical module is foundation/policy/lifecycle.py (enforcement/task_lifecycle.py is a shim). - Backend team stack: vector store is PostgreSQL + pgvector (via piragi), not Qdrant; mypy targets roboco/, not src/. - .env.example: replaced the phantom Qdrant/OpenAI blocks with the real Ollama/RAG settings.
97 lines
4.1 KiB
Bash
97 lines
4.1 KiB
Bash
# =============================================================================
|
|
# RoboCo Environment Configuration
|
|
# =============================================================================
|
|
# Copy this file to .env
|
|
#
|
|
# NOTE: No API keys needed for agents - they use your Claude Code authentication.
|
|
# Run `claude` on the host to authenticate before starting RoboCo.
|
|
|
|
# =============================================================================
|
|
# Docker Deployment (NAS/Server)
|
|
# =============================================================================
|
|
# These are REQUIRED when running via docker compose on a NAS/server.
|
|
# They tell the orchestrator container where to find files on the HOST.
|
|
|
|
# Path to the project on the host (absolute path)
|
|
# ROBOCO_HOST_PROJECT_DIR=/volume1/roboco
|
|
|
|
# Path to Claude Code auth directory on the host
|
|
# ROBOCO_HOST_CLAUDE_DIR=/root/.claude
|
|
|
|
# Claude auth directory to mount into orchestrator
|
|
# CLAUDE_AUTH_DIR=~/.claude
|
|
|
|
# =============================================================================
|
|
# Data Persistence
|
|
# =============================================================================
|
|
# Set to a path on your NAS RAID array for durability
|
|
# Path to data directory on the host (MUST be absolute for Docker-in-Docker)
|
|
# ROBOCO_DATA_DIR=/volume1/roboco/data
|
|
|
|
# =============================================================================
|
|
# Application
|
|
# =============================================================================
|
|
ROBOCO_ENVIRONMENT=development
|
|
ROBOCO_DEBUG=true
|
|
|
|
# =============================================================================
|
|
# API Server
|
|
# =============================================================================
|
|
ROBOCO_HOST=0.0.0.0
|
|
ROBOCO_PORT=8000
|
|
|
|
# =============================================================================
|
|
# Database (PostgreSQL)
|
|
# =============================================================================
|
|
# For docker compose deployment, use container name:
|
|
# ROBOCO_DATABASE_HOST=roboco-postgres
|
|
# For local development:
|
|
ROBOCO_DATABASE_HOST=localhost
|
|
ROBOCO_DATABASE_PORT=5432
|
|
ROBOCO_DATABASE_USER=roboco
|
|
ROBOCO_DATABASE_PASSWORD=roboco
|
|
ROBOCO_DATABASE_NAME=roboco
|
|
ROBOCO_DATABASE_ECHO=false
|
|
|
|
# =============================================================================
|
|
# Redis
|
|
# =============================================================================
|
|
# For docker compose deployment, use container name:
|
|
# ROBOCO_REDIS_HOST=roboco-redis
|
|
# For local development:
|
|
ROBOCO_REDIS_HOST=localhost
|
|
ROBOCO_REDIS_PORT=6379
|
|
ROBOCO_REDIS_DB=0
|
|
# ROBOCO_REDIS_PASSWORD=
|
|
|
|
# =============================================================================
|
|
# RAG / Local LLM (Ollama + pgvector via piragi)
|
|
# =============================================================================
|
|
# For docker compose use the container name (roboco-ollama); locally, localhost.
|
|
ROBOCO_OLLAMA_BASE_URL=http://localhost:11434
|
|
ROBOCO_LOCAL_LLM_BASE_URL=http://localhost:11434/v1
|
|
ROBOCO_LOCAL_LLM_MODEL=glm-5:cloud
|
|
ROBOCO_DEFAULT_EMBEDDING_MODEL=qwen3-embedding:0.6b
|
|
|
|
# =============================================================================
|
|
# Security
|
|
# =============================================================================
|
|
# Agent auth: HMAC secret that signs X-Agent-Token. REQUIRED for docker compose.
|
|
# Generate with: python -c 'import secrets; print(secrets.token_hex(32))'
|
|
ROBOCO_AGENT_AUTH_SECRET=
|
|
|
|
# Secure mode. On a trusted LAN you can leave this false (header-trust mode).
|
|
# Set true to require every request to carry a valid token so an agent cannot
|
|
# spoof another agent's role. When true you MUST also set ROBOCO_PANEL_AGENT_TOKEN.
|
|
ROBOCO_AGENT_AUTH_REQUIRED=false
|
|
|
|
# The control panel's CEO token, injected by nginx in secure mode so the human
|
|
# UI keeps working without the browser holding the signing secret. Generate it
|
|
# (after setting ROBOCO_AGENT_AUTH_SECRET above) with: make panel-token
|
|
ROBOCO_PANEL_AGENT_TOKEN=
|
|
|
|
# =============================================================================
|
|
# CORS (comma-separated origins)
|
|
# =============================================================================
|
|
ROBOCO_CORS_ORIGINS=["http://localhost:3000","http://localhost:5173"]
|