LIghtJUNction
22 KiB
English ｜ 繁體中文 ｜ 日本語 ｜ Français ｜ 简体中文
Главная ｜ Документация ｜ Блог ｜ Roadmap ｜ Сообщить о проблеме Email
AstrBot — это универсальный агентский помощник для личных и групповых чатов с открытым исходным кодом. Он может быть развернут в десятках популярных мессенджеров, таких как QQ, Telegram, WeCom (Enterprise WeChat), Lark (Feishu), DingTalk, Slack и других. Кроме того, он имеет встроенный легковесный веб-интерфейс чата (ChatUI), похожий на OpenWebUI, создавая надежную и масштабируемую диалоговую интеллектуальную инфраструктуру для частных лиц, разработчиков и команд. Будь то личный AI-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний, AstrBot позволяет быстро создавать AI-приложения в рабочем процессе ваших платформ обмена мгновенными сообщениями.
Основные возможности
- 💯 Бесплатно и с открытым исходным кодом.
- ✨ Поддержка диалога с большими языковыми моделями (LLM), мультимодальность, Агенты, MCP, Навыки (Skills), База знаний, Персонализация, автоматическое сжатие диалога.
- 🤖 Поддержка интеграции с платформами агентов, такими как Dify, Alibaba Bailian, Coze и др.
- 🌐 Мультиплатформенность: поддержка QQ, WeCom, Lark, DingTalk, WeChat Official Account, Telegram, Slack и других.
- 📦 Расширение плагинами: доступно более 1000 плагинов для установки в один клик.
- 🛡️ Agent Sandbox: Изолированная среда для безопасного выполнения любого кода, вызова Shell и повторного использования ресурсов на уровне сессии.
- 💻 Поддержка WebUI.
- 🌈 Поддержка Web ChatUI: встроенная прокси-песочница, веб-поиск и многое другое внутри ChatUI.
- 🌐 Поддержка интернационализации (i18n).
| 💙 Ролевые игры и Эмоциональное общение | ✨ Проактивный Агент | 🚀 Общие агентские возможности | 🧩 1000+ Плагинов сообщества |
|---|---|---|---|
Быстрый старт
Развертывание в один клик
Для пользователей, которые хотят быстро протестировать AstrBot, знакомы с командной строкой и могут самостоятельно установить среду uv, мы рекомендуем метод развертывания в один клик с помощью uv ⚡️.
uv tool install astrbot
astrbot init # Выполните эту команду только в первый раз для инициализации среды
astrbot run # astrbot run --backend-only запускает только бэкенд сервис
# Установка версии для разработчиков (больше исправлений и новых функций, но менее стабильна; подходит для разработчиков)
uv tool install git+https://github.com/AstrBotDevs/AstrBot@dev
Требуется установленный uv.
Note
Для пользователей macOS: Из-за проверок безопасности macOS первый запуск команды
astrbotможет занять длительное время (около 10-20 секунд).
Обновление astrbot:
uv tool upgrade astrbot
Развертывание через Docker
Для пользователей, знакомых с контейнерами и предпочитающих более стабильный метод развертывания, подходящий для производственных сред, мы рекомендуем использовать Docker / Docker Compose для развертывания AstrBot.
Пожалуйста, обратитесь к официальной документации Развертывание 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 (Служба поддержки & Официальный аккаунт) | Официальная |
| Lark (Feishu) | Официальная |
| DingTalk | Официальная |
| Slack | Официальная |
| Discord | Официальная |
| LINE | Официальная |
| Satori | Официальная |
| Misskey | Официальная |
| Whatsapp (Скоро) | Официальная |
| Matrix | Сообщество |
| KOOK | Сообщество |
| VoceChat | Сообщество |
Поддерживаемые провайдеры моделей
| Провайдер | Тип |
|---|---|
| Пользовательский | Любой сервис, совместимый с 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 |
| Alibaba 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) |
| Alibaba Bailian TTS | Синтез речи (TTS) |
| Azure TTS | Синтез речи (TTS) |
| Minimax TTS | Синтез речи (TTS) |
| Volcengine TTS | Синтез речи (TTS) |
❤️ Вклад в проект
Мы приветствуем любые Issues и Pull Requests! Просто отправьте свои изменения в этот проект :)
Как внести вклад
Вы можете внести свой вклад, просматривая проблемы (Issues) или помогая проверять PR (Pull Requests). Любая проблема или PR приветствуются для поощрения участия сообщества. Конечно, это всего лишь предложения, вы можете внести свой вклад любым способом. Для добавления новых функций, пожалуйста, сначала обсудите это через Issue.
Рекомендуется объединять функциональные PR в ветку dev, которая будет объединена с основной веткой (main) и выпущена как новая версия после тестирования изменений.
Для уменьшения конфликтов мы рекомендуем:
- Создавайте рабочую ветку на основе ветки
dev, избегайте работы напрямую в веткеmain. - При отправке PR выбирайте ветку
devв качестве целевой. - Регулярно синхронизируйте ветку
devс локальной средой, чаще используйтеgit pull.
Среда разработки
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 - Отличный антропоморфный AI ChatBot
- nekro-agent - Отличный агентский ChatBot
- LangBot - Отличный мультиплатформенный AI ChatBot
- ChatLuna - Отличный плагин мультиплатформенного AI ChatBot для Koishi
- Operit AI - Отличное Android-приложение интеллектуального AI-помощника
⭐ История звезд
Tip
Если этот проект помог вам в жизни или работе, или если вы заинтересованы в будущем развитии этого проекта, пожалуйста, поставьте проекту звезду (Star). Это наша мотивация поддерживать этот проект с открытым исходным кодом <3
Компаньонство и способности никогда не должны быть противоположностями. Мы надеемся создать робота, который сможет одновременно понимать эмоции, быть компаньоном и надежно выполнять работу.
私は、高性能ですから! (Я высокопроизводительный!)
