20 KiB
AstrBot — это универсальный агентный помощник для личных и групповых чатов с открытым исходным кодом. Он может быть развернут в десятках популярных мессенджеров, таких как QQ, Telegram, WeCom, Lark (Feishu), DingTalk, Slack и других. Кроме того, он имеет встроенный легковесный веб-интерфейс ChatUI, похожий на OpenWebUI, что создает надежную и масштабируемую инфраструктуру диалогового ИИ для частных лиц, разработчиков и команд. Будь то личный ИИ-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний, AstrBot позволяет быстро создавать ИИ-приложения в рабочем процессе вашей платформы обмена сообщениями.
Основные возможности
- 💯 Бесплатно и с открытым исходным кодом.
- ✨ LLM чат, мультимодальность, Агенты, MCP, Навыки, База знаний, Настройки личности, Авто-сжатие контекста.
- 🤖 Поддержка интеграции с платформами агентов, такими как Dify, Aliyun Bailian, Coze и др.
- 🌐 Мультиплатформенность: поддержка QQ, WeCom, Lark, DingTalk, WeChat Official, Telegram, Slack и других.
- 📦 Расширение плагинами: более 1000 плагинов доступны для установки в один клик.
- 🛡️ Agent Sandbox: Изолированная среда для безопасного выполнения кода, вызова Shell и повторного использования ресурсов на уровне сессии.
- 💻 Поддержка WebUI.
- 🌈 Поддержка Web ChatUI: встроенная песочница агента, веб-поиск и многое другое.
- 🌐 Поддержка интернационализации (i18n).
| 💙 Ролевые игры и Эмоциональное общение | ✨ Проактивный Агент | 🚀 Общие агентные возможности | 🧩 1000+ плагинов сообщества |
|---|---|---|---|
Быстрый старт
Развертывание в один клик
Для пользователей, которые хотят быстро попробовать AstrBot, знакомы с командной строкой и могут самостоятельно установить среду uv, мы рекомендуем метод развертывания в один клик с помощью uv ⚡️.
uv tool install astrbot
astrbot init # Выполните эту команду только в первый раз для инициализации среды
astrbot run
Требуется установка uv.
Note
Для пользователей macOS: из-за проверки безопасности macOS первый запуск команды
astrbotможет занять длительное время (около 10-20 секунд).
Обновление astrbot:
uv tool upgrade astrbot
Docker развертывание
Для пользователей, знакомых с контейнерами и предпочитающих более стабильный метод развертывания, подходящий для продакшн-среды, мы рекомендуем использовать Docker / Docker Compose.
Пожалуйста, обратитесь к официальной документации Развертывание AstrBot с помощью Docker.
Развертывание на RainYun
Для пользователей, которые хотят развернуть AstrBot в один клик и не хотят самостоятельно управлять серверами, мы рекомендуем облачный сервис развертывания RainYun ☁️:
Клиент для рабочего стола
Для пользователей, которые хотят использовать AstrBot на рабочем столе и использовать ChatUI в качестве основного интерфейса, мы рекомендуем AstrBot App.
Перейдите на AstrBot-desktop для загрузки и установки; этот метод предназначен для использования на десктопе и не рекомендуется для серверных сценариев.
Развертывание через Лаунчер
Также для настольных ПК, для пользователей, которые хотят быстрого развертывания и изоляции среды для нескольких экземпляров, мы рекомендуем AstrBot Launcher.
Перейдите на AstrBot Launcher для загрузки и установки.
Развертывание на Replit
Развертывание на Replit поддерживается сообществом и подходит для онлайн-демонстраций и легких пробных сценариев.
AUR
Метод AUR предназначен для пользователей Arch Linux, которые хотят установить AstrBot через системный менеджер пакетов.
Выполните следующую команду в терминале, чтобы установить пакет astrbot-git. После установки вы можете запустить его.
yay -S astrbot-git
Другие методы развертывания
Если вам нужно панельное управление или более глубокая настройка, обратитесь к BT Panel (установка из магазина приложений BT Panel), 1Panel (установка из магазина приложений 1Panel), CasaOS (визуальное развертывание на NAS / домашнем сервере) и Ручное развертывание (полная пользовательская установка на основе исходного кода и uv).
Поддерживаемые платформы обмена сообщениями
Подключите AstrBot к вашей любимой чат-платформе.
| Платформа | Мейнтейнер |
|---|---|
| Официальный | |
| OneBot v11 | Официальный |
| Telegram | Официальный |
| Приложение WeCom и бот | Официальный |
| WeChat Customer Service & Official Account | Официальный |
| Lark (Feishu) | Официальный |
| DingTalk | Официальный |
| Slack | Официальный |
| Discord | Официальный |
| LINE | Официальный |
| Satori | Официальный |
| Misskey | Официальный |
| Whatsapp (Скоро) | Официальный |
| Matrix | Сообщество |
| KOOK | Сообщество |
| VoceChat | Сообщество |
Поддерживаемые провайдеры моделей
| Провайдер | Тип |
|---|---|
| Custom | Любой сервис, совместимый с OpenAI API |
| OpenAI | LLM |
| Anthropic | LLM |
| Google Gemini | LLM |
| Moonshot AI | LLM |
| Zhipu AI | LLM |
| DeepSeek | LLM |
| Ollama (Локально) | LLM |
| LM Studio (Локально) | LLM |
| AIHubMix | LLM (API шлюз, поддержка всех моделей) |
| Uyun AI | LLM (API шлюз, поддержка всех моделей) |
| SiliconFlow | LLM (API шлюз, поддержка всех моделей) |
| PPIO | LLM (API шлюз, поддержка всех моделей) |
| 302.AI | LLM (API шлюз, поддержка всех моделей) |
| TokenPony | LLM (API шлюз, поддержка всех моделей) |
| ModelScope | LLM |
| OneAPI | LLM |
| Dify | LLMOps платформа |
| Aliyun Bailian | LLMOps платформа |
| Coze | LLMOps платформа |
| OpenAI Whisper | Распознавание речи (STT) |
| SenseVoice | Распознавание речи (STT) |
| OpenAI TTS | Синтез речи (TTS) |
| Gemini TTS | Синтез речи (TTS) |
| GPT-Sovits-Inference | Синтез речи (TTS) |
| GPT-Sovits | Синтез речи (TTS) |
| FishAudio | Синтез речи (TTS) |
| Edge TTS | Синтез речи (TTS) |
| Aliyun Bailian TTS | Синтез речи (TTS) |
| Azure TTS | Синтез речи (TTS) |
| Minimax TTS | Синтез речи (TTS) |
| Volcengine TTS | Синтез речи (TTS) |
❤️ Вклад
Приветствуются любые Issues и Pull Requests! Просто отправьте ваши изменения в этот проект :)
Как внести вклад
Вы можете внести свой вклад, просматривая issues или помогая в проверке PR (Pull Requests). Любая проблема или PR приветствуются для поощрения участия сообщества. Конечно, это всего лишь предложения, и вы можете вносить вклад любым удобным для вас способом. Для добавления новых функций, пожалуйста, сначала обсудите это через Issue.
Рекомендуется объединять функциональные PR в ветку dev, которая будет объединена с основной веткой и выпущена как новая версия после тестирования изменений.
Среда разработки
AstrBot использует ruff для форматирования и проверки кода.
git clone https://github.com/AstrBotDevs/AstrBot
git switch dev # Переключиться на ветку разработки
pip install pre-commit # или uv tool install pre-commit
pre-commit install
Рекомендуется использовать uv для локальной установки и тестирования:
uv tool install -e . --force
astrbot init
astrbot run
Отладка фронтенда:
astrbot run --backend-only
cd dashboard
bun install # или pnpm и т.д.
bun dev
Группы QQ
- Группа 9: 1076659624 (Новая)
- Группа 10: 1078079676 (Новая)
- Группа 1: 322154837
- Группа 3: 630166526
- Группа 5: 822130018
- Группа 6: 753075035
- Группа 7: 743746109
- Группа 8: 1030353265
- Группа разработчиков (Болталка): 975206796
- Группа разработчиков (Официальная): 1039761811
Канал Discord
❤️ Особая благодарность
Особая благодарность всем контрибьюторам и разработчикам плагинов за их вклад в AstrBot ❤️
Кроме того, рождение этого проекта было бы невозможно без помощи следующих проектов с открытым исходным кодом:
- NapNeko/NapCatQQ - Великий кошачий фреймворк
Дружественные проекты с открытым исходным кодом:
- NoneBot2 - Отличный асинхронный ChatBot фреймворк на Python
- Koishi - Отличный ChatBot фреймворк на Node.js
- MaiBot - Отличный антропоморфный ИИ ChatBot
- nekro-agent - Отличный агентный ChatBot
- LangBot - Отличный мультиплатформенный ИИ ChatBot
- ChatLuna - Отличный плагин мультиплатформенного ИИ ChatBot для Koishi
- Operit AI - Отличное Android-приложение интеллектуального ИИ-помощника
⭐ Star History
Tip
Если этот проект помог вам в жизни или работе, или если вас интересует его будущее развитие, пожалуйста, поставьте проекту звезду (Star). Это наша мотивация для поддержки этого проекта с открытым исходным кодом <3
