BLOC (BLOC Layer for OpenCode) is a minimal Docker Compose setup for running OpenCode on its own or connecting it to Telegram.
This BLOC release is qualified with OpenCode v1.19.3. OpenCode v2 is not yet qualified.
- Run OpenCode with a configurable AI provider in Docker.
- Optionally query it from Telegram through a dependency-free Python bridge.
- Keep one persistent OpenCode session per Telegram chat.
- Access the same server through the local OpenCode TUI without publishing its API port.
Run make help for the available commands.
- Quickstart: configure, start, and stop BLOC.
- Usage: Telegram formatting, sessions, and cost reporting.
- Provider: configure Opper AI and select a model.
- Security: trust boundaries and safe deployment.
- Coolify deployment: deploy with Coolify Compose.
- Contributing: tests and release process.