CoCo

An AI Copilot.

Quick Start

Docker Compose is the recommended deployment path:

cp .env.example .env
${EDITOR:-vi} .env
mkdir -p .coco-data .coco-workspace
docker compose up -d

Set COCO_UID to id -u and COCO_GID to id -g before starting Compose. See Docker Compose Deployment for .env, ChatGPT OAuth, Telegram channel, cronjob skill, and runtime UID/GID details.

Local Image Build

nix build .#coco-image
docker load < result

Use .#coco-image-linux-amd64 or .#coco-image-linux-arm64 when you need a specific Linux image architecture. See Docker Compose Deployment for published image and local build notes.

After loading the local image, set COCO_IMAGE=coco:latest in .env.

Documentation

• CoCo Docs
• Docker Compose Deployment

Acknowledgements

Thanks to codex and bub for the inspiration and implementation references.