whatisgithub

What is flock?

duckbugio/flock — explained in plain English

Analysis updated 2026-05-18

36GoAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

A self-hosted service that turns Claude into a small AI dev team you direct over Telegram, from planning through opening a pull request.

Mindmap

mindmap
  root((DuckFlock))
    What it does
      Telegram driven AI dev team
      Plan code test review pipeline
      Auto opens pull requests
    Tech stack
      Go
      Docker container
      Telegram Bot API
    Use cases
      Delegate feature work
      Multiple isolated workspaces
      Voice message instructions
    Audience
      Developers
      Small teams
    Setup
      Needs Claude access
      Needs Git host link

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Delegate a feature request to an AI pipeline that plans, codes, tests, reviews, and opens a PR

USE CASE 2

Direct code changes to your repo from a Telegram chat instead of a terminal

USE CASE 3

Run isolated AI coding workspaces for multiple projects or team members at once

USE CASE 4

Send a voice message describing a feature and have it transcribed into a coding task

What is it built with?

GoDockerTelegram Bot APIClaude APIGit

How does it compare?

duckbugio/flockninehills/pdf2mdinternetkafe/cfsearch
Stars363635
LanguageGoGoGo
Setup difficultyhardhardmoderate
Complexity4/54/52/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a Claude subscription or Anthropic API key plus a Telegram bot and Docker.

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

DuckFlock is a service you run on your own server that turns Claude, Anthropic's AI system, into a small software development team you can direct through Telegram. You describe what you want built in a Telegram chat message, and a pipeline of automated AI roles takes it from there: one role plans the work, another writes the code, a third runs tests, a fourth reviews the changes and posts comments, and a fifth decides whether the result is ready or needs another pass. When the work passes review, the system opens a pull request in your code repository automatically. The setup runs as a Docker container, which is a self-contained package you can start with a few terminal commands. You connect it to your Telegram bot account, authorize which Telegram users are allowed to send it instructions, and optionally link it to a Git host such as GitHub, Gitea, or GitLab so it can clone repositories and create branches. Each Telegram conversation gets its own isolated workspace on disk, so different chats cannot see each other's files, and multiple conversations can run at the same time. The system works with a Claude subscription (the same account type used in Claude.ai) or an Anthropic API key, which controls how the AI usage is billed. Voice messages are also supported: record a message in Telegram describing what you want, and the system transcribes it and treats it as a written instruction. The project is primarily aimed at developers who want to delegate routine feature work or code changes to an AI pipeline without manually prompting each step. It is written in Go, MIT licensed, and structured so that Telegram is just one adapter on top of a shared core, with other chat platforms expected to be added later.

Copy-paste prompts

Prompt 1
Help me deploy DuckFlock's Docker container and connect it to my Telegram bot.
Prompt 2
Show me how to link DuckFlock to my GitHub repo so it can open pull requests automatically.
Prompt 3
Explain how DuckFlock's plan-code-test-review-approve pipeline works stage by stage.
Prompt 4
Walk me through authorizing specific Telegram users to send DuckFlock coding instructions.

Frequently asked questions

What is flock?

A self-hosted service that turns Claude into a small AI dev team you direct over Telegram, from planning through opening a pull request.

What language is flock written in?

Mainly Go. The stack also includes Go, Docker, Telegram Bot API.

What license does flock use?

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is flock to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is flock for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.