mcp-server

AstrBot: AI Agent Assistant

Name: AstrBot: AI Agent Assistant
Author: AstrBotDevs

Get an AI-powered chatbot framework.

intermediate⏱ 1-2 hours💵 Free + LLM API costs

39,536 stars2,832 forksPythonGuide quality 8/10 · reviewed Jun 5Updated 8/24/2026100% free · open source

What it is

Host and manage your own AI-powered chatbot across multiple platforms and services.

Real use case example

"A founder wants to build a chatbot for their startup's Discord community. They use AstrBot to create a bot that answers common questions, integrates with Gemini for user authentication, and uses a large language model to provide helpful responses. After setting up the bot, they can use it to engage with their community and collect feedback."

When to use it

•Creating a customer support chatbot that works across multiple messaging platforms
•Building an internal team communication AI assistant
•Developing a prototype conversational interface for a product idea

Ready-to-paste prompt

astrbot init --platform telegram --llm openai --name CustomerSupportBot

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/astrbot && curl -fsSL https://workflowstacks.com/api/skills/astrbot/claude-skill -o ~/.claude/skills/astrbot/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How AstrBot: AI Agent Assistant works

Codeflow

Free to inspect

AstrBot: AI Agent Assistant is a very large Python project (~211k lines across 767 code files, plus 171 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, AGPL-3.0 license, has a test suite.

Size

Very large codebase

~211k lines · 767 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Python · Docker

No API keys detected

Python 71%Vue 21%TypeScript 5%JavaScript 2%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
main.py
Where the program starts running
4
pyproject.toml
Dependencies and the commands it exposes
5
astrbot/__init__.py
Inside astrbot/ — the main logic begins here

What's in each folder

astrbot/Core code — the actual logic518 files

docs/Documentation240 files

samples/Examples you can copy1 files

dashboard/Folder418 files

changelogs/Folder202 files

k8s/Deployment / infrastructure10 files

scripts/Helper scripts7 files

openspec/Folder2 files

READMEHas testsDocumentedCI checksDocker readyExamples includedAGPL-3.0 licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/astrbot && curl -fsSL https://workflowstacks.com/api/skills/astrbot/claude-skill -o ~/.claude/skills/astrbot/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

AstrBotDevs

Language

Python

Do this with a working workflow

Pages we wrote and tested that put a skill like this to work — importable n8n templates, outcome guides and Claude Desktop configs.

Free n8n template

AI Support Agent (Chat)

A chat agent that answers customer questions from YOUR business info — with conversation memory. It never invents policies; anything it doesn't know, it hands to a human.