mirror of
https://github.com/AstrBotDevs/AstrBot
synced 2026-07-20 02:55:08 +08:00
290 lines
20 KiB
Markdown
290 lines
20 KiB
Markdown
|
||
|
||
<div align="center">
|
||
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">English</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh-TW.md">繁體中文</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md">日本語</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md">Français</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a>
|
||
|
||
<div>
|
||
<a href="https://trendshift.io/repositories/12875" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12875" alt="Soulter%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
|
||
<a href="https://hellogithub.com/repository/AstrBotDevs/AstrBot" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d127d50cd5e54c5382328acc3bb25483&claim_uid=ZO9by7qCXgSd6Lp&t=2" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<div>
|
||
<img src="https://img.shields.io/github/v/release/AstrBotDevs/AstrBot?color=76bad9" href="https://github.com/AstrBotDevs/AstrBot/releases/latest">
|
||
<img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
|
||
<img src="https://deepwiki.com/badge.svg" href="https://deepwiki.com/AstrBotDevs/AstrBot">
|
||
<a href="https://zread.ai/AstrBotDevs/AstrBot" target="_blank"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTk4IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="zread"/></a>
|
||
<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?color=76bad9"/></a>
|
||
<img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.soulter.top%2Fastrbot%2Fplugin-num&query=%24.result&suffix=%20Plugins&label=%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%82%D0%BF%D0%BB%D0%B5%D0%B9%D1%81&cacheSeconds=3600">
|
||
<img src="https://gitcode.com/Soulter/AstrBot/star/badge.svg" href="https://gitcode.com/Soulter/AstrBot">
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<a href="https://astrbot.app/">Главная</a> ｜
|
||
<a href="https://astrbot.app/">Документация</a> ｜
|
||
<a href="https://blog.astrbot.app/">Блог</a> ｜
|
||
<a href="https://astrbot.featurebase.app/roadmap">Roadmap</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/issues">Issues</a>
|
||
<a href="mailto:community@astrbot.app">Email</a>
|
||
|
||
</div>
|
||
|
||
AstrBot — это универсальный агентный помощник для личных и групповых чатов с открытым исходным кодом. Он может быть развернут в десятках популярных мессенджеров, таких как QQ, Telegram, WeCom, Lark (Feishu), DingTalk, Slack и других. Кроме того, он имеет встроенный легковесный веб-интерфейс ChatUI, похожий на OpenWebUI, что создает надежную и масштабируемую инфраструктуру диалогового ИИ для частных лиц, разработчиков и команд. Будь то личный ИИ-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний, AstrBot позволяет быстро создавать ИИ-приложения в рабочем процессе вашей платформы обмена сообщениями.
|
||
|
||
|
||
|
||
## Основные возможности
|
||
|
||
1. 💯 Бесплатно и с открытым исходным кодом.
|
||
2. ✨ LLM чат, мультимодальность, Агенты, MCP, Навыки, База знаний, Настройки личности, Авто-сжатие контекста.
|
||
3. 🤖 Поддержка интеграции с платформами агентов, такими как Dify, Aliyun Bailian, Coze и др.
|
||
4. 🌐 Мультиплатформенность: поддержка QQ, WeCom, Lark, DingTalk, WeChat Official, Telegram, Slack и [других](#поддерживаемые-платформы-обмена-сообщениями).
|
||
5. 📦 Расширение плагинами: более 1000 плагинов доступны для установки в один клик.
|
||
6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html): Изолированная среда для безопасного выполнения кода, вызова Shell и повторного использования ресурсов на уровне сессии.
|
||
7. 💻 Поддержка WebUI.
|
||
8. 🌈 Поддержка Web ChatUI: встроенная песочница агента, веб-поиск и многое другое.
|
||
9. 🌐 Поддержка интернационализации (i18n).
|
||
|
||
<br>
|
||
|
||
<table align="center">
|
||
<tr align="center">
|
||
<th>💙 Ролевые игры и Эмоциональное общение</th>
|
||
<th>✨ Проактивный Агент</th>
|
||
<th>🚀 Общие агентные возможности</th>
|
||
<th>🧩 1000+ плагинов сообщества</th>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><p align="center"><img width="984" height="1746" alt="99b587c5d35eea09d84f33e6cf6cfd4f" src="https://github.com/user-attachments/assets/89196061-3290-458d-b51f-afa178049f84" /></p></td>
|
||
<td align="center"><p align="center"><img width="976" height="1612" alt="c449acd838c41d0915cc08a3824025b1" src="https://github.com/user-attachments/assets/f75368b4-e022-41dc-a9e0-131c3e73e32e" /></p></td>
|
||
<td align="center"><p align="center"><img width="974" height="1732" alt="image" src="https://github.com/user-attachments/assets/e22a3968-87d7-4708-a7cd-e7f198c7c32e" /></p></td>
|
||
<td align="center"><p align="center"><img width="976" height="1734" alt="image" src="https://github.com/user-attachments/assets/0952b395-6b4a-432a-8a50-c294b7f89750" /></p></td>
|
||
</tr>
|
||
</table>
|
||
|
||
## Быстрый старт
|
||
|
||
### Развертывание в один клик
|
||
|
||
Для пользователей, которые хотят быстро попробовать AstrBot, знакомы с командной строкой и могут самостоятельно установить среду `uv`, мы рекомендуем метод развертывания в один клик с помощью `uv` ⚡️.
|
||
|
||
```bash
|
||
uv tool install astrbot
|
||
astrbot init # Выполните эту команду только в первый раз для инициализации среды
|
||
astrbot run
|
||
```
|
||
|
||
> Требуется установка [uv](https://docs.astral.sh/uv/).
|
||
|
||
> [!NOTE]
|
||
> Для пользователей macOS: из-за проверки безопасности macOS первый запуск команды `astrbot` может занять длительное время (около 10-20 секунд).
|
||
|
||
Обновление `astrbot`:
|
||
|
||
```bash
|
||
uv tool upgrade astrbot
|
||
```
|
||
|
||
### Docker развертывание
|
||
|
||
Для пользователей, знакомых с контейнерами и предпочитающих более стабильный метод развертывания, подходящий для продакшн-среды, мы рекомендуем использовать Docker / Docker Compose.
|
||
|
||
Пожалуйста, обратитесь к официальной документации [Развертывание AstrBot с помощью Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
|
||
|
||
### Развертывание на RainYun
|
||
|
||
Для пользователей, которые хотят развернуть AstrBot в один клик и не хотят самостоятельно управлять серверами, мы рекомендуем облачный сервис развертывания RainYun ☁️:
|
||
|
||
[](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
|
||
|
||
### Клиент для рабочего стола
|
||
|
||
Для пользователей, которые хотят использовать AstrBot на рабочем столе и использовать ChatUI в качестве основного интерфейса, мы рекомендуем AstrBot App.
|
||
|
||
Перейдите на [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) для загрузки и установки; этот метод предназначен для использования на десктопе и не рекомендуется для серверных сценариев.
|
||
|
||
### Развертывание через Лаунчер
|
||
|
||
Также для настольных ПК, для пользователей, которые хотят быстрого развертывания и изоляции среды для нескольких экземпляров, мы рекомендуем AstrBot Launcher.
|
||
|
||
Перейдите на [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) для загрузки и установки.
|
||
|
||
### Развертывание на Replit
|
||
|
||
Развертывание на Replit поддерживается сообществом и подходит для онлайн-демонстраций и легких пробных сценариев.
|
||
|
||
[](https://repl.it/github/AstrBotDevs/AstrBot)
|
||
|
||
### AUR
|
||
|
||
Метод AUR предназначен для пользователей Arch Linux, которые хотят установить AstrBot через системный менеджер пакетов.
|
||
|
||
Выполните следующую команду в терминале, чтобы установить пакет `astrbot-git`. После установки вы можете запустить его.
|
||
|
||
```bash
|
||
yay -S astrbot-git
|
||
```
|
||
|
||
**Другие методы развертывания**
|
||
|
||
Если вам нужно панельное управление или более глубокая настройка, обратитесь к [BT Panel](https://astrbot.app/deploy/astrbot/btpanel.html) (установка из магазина приложений BT Panel), [1Panel](https://astrbot.app/deploy/astrbot/1panel.html) (установка из магазина приложений 1Panel), [CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) (визуальное развертывание на NAS / домашнем сервере) и [Ручное развертывание](https://astrbot.app/deploy/astrbot/cli.html) (полная пользовательская установка на основе исходного кода и `uv`).
|
||
|
||
## Поддерживаемые платформы обмена сообщениями
|
||
|
||
Подключите AstrBot к вашей любимой чат-платформе.
|
||
|
||
| Платформа | Мейнтейнер |
|
||
|---------|---------------|
|
||
| **QQ** | Официальный |
|
||
| **OneBot v11** | Официальный |
|
||
| **Telegram** | Официальный |
|
||
| **Приложение WeCom и бот** | Официальный |
|
||
| **WeChat Customer Service & Official Account** | Официальный |
|
||
| **Lark (Feishu)** | Официальный |
|
||
| **DingTalk** | Официальный |
|
||
| **Slack** | Официальный |
|
||
| **Discord** | Официальный |
|
||
| **LINE** | Официальный |
|
||
| **Satori** | Официальный |
|
||
| **Misskey** | Официальный |
|
||
| **Whatsapp (Скоро)** | Официальный |
|
||
| [**Matrix**](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Сообщество |
|
||
| [**KOOK**](https://github.com/wuyan1003/astrbot_plugin_kook_adapter) | Сообщество |
|
||
| [**VoceChat**](https://github.com/HikariFroya/astrbot_plugin_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](https://aihubmix.com/?aff=4bfH) | LLM (API шлюз, поддержка всех моделей) |
|
||
| [Uyun AI](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM (API шлюз, поддержка всех моделей) |
|
||
| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM (API шлюз, поддержка всех моделей) |
|
||
| [PPIO](https://ppio.com/user/register?invited_by=AIOONE) | LLM (API шлюз, поддержка всех моделей) |
|
||
| [302.AI](https://share.302.ai/rr1M3l) | LLM (API шлюз, поддержка всех моделей)|
|
||
| [TokenPony](https://www.tokenpony.cn/3YPyf) | 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` для форматирования и проверки кода.
|
||
|
||
```bash
|
||
git clone https://github.com/AstrBotDevs/AstrBot
|
||
git switch dev # Переключиться на ветку разработки
|
||
pip install pre-commit # или uv tool install pre-commit
|
||
pre-commit install
|
||
```
|
||
Рекомендуется использовать uv для локальной установки и тестирования:
|
||
```bash
|
||
uv tool install -e . --force
|
||
astrbot init
|
||
astrbot run
|
||
```
|
||
Отладка фронтенда:
|
||
```bash
|
||
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
|
||
|
||
- [Discord](https://discord.gg/hAVk6tgV36)
|
||
|
||
## ❤️ Особая благодарность
|
||
|
||
Особая благодарность всем контрибьюторам и разработчикам плагинов за их вклад в AstrBot ❤️
|
||
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot&max=200&columns=14" />
|
||
</a>
|
||
|
||
Кроме того, рождение этого проекта было бы невозможно без помощи следующих проектов с открытым исходным кодом:
|
||
|
||
- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Великий кошачий фреймворк
|
||
|
||
Дружественные проекты с открытым исходным кодом:
|
||
|
||
- [NoneBot2](https://github.com/nonebot/nonebot2) - Отличный асинхронный ChatBot фреймворк на Python
|
||
- [Koishi](https://github.com/koishijs/koishi) - Отличный ChatBot фреймворк на Node.js
|
||
- [MaiBot](https://github.com/Mai-with-u/MaiBot) - Отличный антропоморфный ИИ ChatBot
|
||
- [nekro-agent](https://github.com/KroMiose/nekro-agent) - Отличный агентный ChatBot
|
||
- [LangBot](https://github.com/langbot-app/LangBot) - Отличный мультиплатформенный ИИ ChatBot
|
||
- [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Отличный плагин мультиплатформенного ИИ ChatBot для Koishi
|
||
- [Operit AI](https://github.com/AAswordman/Operit) - Отличное Android-приложение интеллектуального ИИ-помощника
|
||
|
||
## ⭐ Star History
|
||
|
||
> [!TIP]
|
||
> Если этот проект помог вам в жизни или работе, или если вас интересует его будущее развитие, пожалуйста, поставьте проекту звезду (Star). Это наша мотивация для поддержки этого проекта с открытым исходным кодом <3
|
||
|
||
<div align="center">
|
||
|
||
[](https://star-history.com/#astrbotdevs/astrbot&Date)
|
||
|
||
</div>
|
||
|
||
<div align="center">
|
||
|
||
_Общение и способности никогда не должны быть противоположностями. Мы надеемся создать робота, который сможет понимать эмоции, составлять компанию и надежно выполнять задачи._
|
||
|
||
_私は、高性能ですから!_
|
||
|
||
<img src="https://files.astrbot.app/watashiwa-koseino-desukara.gif" width="100"/>
|
||
|
||
</div> |