# CoStaff — Build Your Own AI Agent Workforce

> Open-source, self-hosted multi-agent system. Hand off tasks in your chat app — specialist AI agents collaborate to get the work done. All on your own machine.

## What CoStaff does

In your chat app (Telegram, LINE, WebChat), you describe a task in plain language. The Manager Agent parses your intent, dispatches to the right specialists. They collaborate via A2A (Agent-to-Agent) protocol and call MCP (Model Context Protocol) tools to deliver results back to your chat — PDFs, Excel files, query results, anything.

## How it works (4 steps)

1. **Hand off** — Just chat in Telegram, LINE, or WebChat. No new system, no new UI to learn.
2. **Dispatch** — Manager Agent parses your intent, routes to the right specialist combination.
3. **Specialists** — BA, Coding, Database, Twinkle Hub agents work in parallel, calling MCP tools as needed.
4. **Done** — Results back in your chat. You don't switch tools.

## Three reasons to choose CoStaff

1. **Specialist Agents** — Manager Agent dispatches automatically (no manual wiring); third-party AI agents collaborate; build your own Custom Agent + MCP tools.
2. **Major Channels** — Currently supports Telegram, LINE, Discord, Slack and other 3rd-party chat apps; build your own Web App / Phone App to connect.
3. **Self-Hosted** — Deploy Docker services quickly via CLI; LLM choice (Gemini / Gemma / Twinkle T1 / 3rd-party); open-source, your data stays on your machine.

## Pages

- [AI Staff (5 specialists)](https://costaffs.app/agents/) — see [agents.md](https://costaffs.app/agents.md)
- [System Architecture](https://costaffs.app/architecture/) — see [architecture.md](https://costaffs.app/architecture.md)
- [User Flow Example](https://costaffs.app/user-flow/) — see [user-flow.md](https://costaffs.app/user-flow.md)

## 中文文件

- [首頁](https://costaffs.app/zhtw/)
- [AI 員工](https://costaffs.app/zhtw/agents/)
- [技術架構](https://costaffs.app/zhtw/architecture/)
- [使用者應用架構圖](https://costaffs.app/zhtw/user-flow/)

## Source code

- GitHub Org: https://github.com/costaff-ai
- Twinkle Hub Agent (open): https://github.com/costaff-ai/costaff-agent-twinkle-hub

## License & contact

- License: AGPL v3 + Commercial license available
- Email: simonliuyuwei@gmail.com
- Early access: https://forms.gle/9UVdi527sYUBuqcm6