中文 |
-English |
日本語 |
繁體中文 |
Français |
@@ -38,7 +37,7 @@
AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.
-
+
## Key Features
@@ -46,12 +45,29 @@ AstrBot is an open-source all-in-one Agent chatbot platform that integrates with
2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
3. 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
4. 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and [more](#supported-messaging-platforms).
-5. 📦 Plugin Extensions with nearly 800 plugins available for one-click installation.
+5. 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) for isolated, safe execution of code, shell calls, and session-level resource reuse.
7. 💻 WebUI Support.
8. 🌈 Web ChatUI Support with built-in agent sandbox and web search.
9. 🌐 Internationalization (i18n) Support.
+
+
+
+
+
💙 Role-playing & Emotional Companionship
+
✨ Proactive Agent
+
🚀 General Agentic Capabilities
+
🧩 1000+ Community Plugins
+
+
+
+
+
+
+
+
+
## Quick Start
#### Docker Deployment (Recommended 🥳)
@@ -63,9 +79,30 @@ Please refer to the official documentation: [Deploy AstrBot with Docker](https:/
#### uv Deployment
```bash
-uvx astrbot
+uv tool install astrbot
+astrbot
+```
+
+#### System Package Manager Installation
+
+##### Arch Linux
+
+```bash
+yay -S astrbot-git
+# or use paru
+paru -S astrbot-git
```
+#### Desktop Application (Tauri)
+
+Desktop repository: [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop).
+
+Supports multiple system architectures, direct installation, out-of-the-box experience. Ideal for beginners.
+
+#### AstrBot Launcher
+
+Quick deployment and multi-instance solution. Visit the [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) repository and find the latest release for your system.
+
#### BT-Panel Deployment
AstrBot has partnered with BT-Panel and is now available in their marketplace.
@@ -131,8 +168,8 @@ Or refer to the official documentation: [Deploy AstrBot from Source](https://ast
- Discord
- Satori
- Misskey
+- LINE
- WhatsApp (Coming Soon)
-- LINE (Coming Soon)
**Community Maintained**
@@ -155,7 +192,7 @@ Or refer to the official documentation: [Deploy AstrBot from Source](https://ast
- [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74)
- [302.AI](https://share.302.ai/rr1M3l)
- [TokenPony](https://www.tokenpony.cn/3YPyf)
-- [SiliconFlow](https://docs.siliconflow.cn/cn/usecases/use-siliconcloud-in-astrbot)
+- [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot)
- [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE)
- ModelScope
- OneAPI
@@ -227,7 +264,7 @@ pre-commit install
Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
-
+
Additionally, the birth of this project would not have been possible without the help of the following open-source projects:
@@ -245,10 +282,10 @@ Additionally, the birth of this project would not have been possible without the
-
-
+_Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks._
+
_私は、高性能ですから!_
diff --git a/README_fr.md b/README_fr.md
index a47e15eead..994cb7677c 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -1,9 +1,13 @@

-
-
-中文 |
-English |
-日本語 |
-繁體中文 |
-Русский
-
Documentation |
Blog |
Feuille de route |
@@ -38,17 +37,36 @@
AstrBot est une plateforme de chatbot Agent tout-en-un open source qui s'intègre aux principales applications de messagerie instantanée. Elle fournit une infrastructure d'IA conversationnelle fiable et évolutive pour les particuliers, les développeurs et les équipes. Que vous construisiez un compagnon IA personnel, un service client intelligent, un assistant d'automatisation ou une base de connaissances d'entreprise, AstrBot vous permet de créer rapidement des applications d'IA prêtes pour la production dans les flux de travail de votre plateforme de messagerie.
-
+
## Fonctionnalités principales
1. 💯 Gratuit & Open Source.
-2. ✨ Conversations avec LLM IA, Multimodal, Agent, MCP, Base de connaissances, Paramètres de personnalité.
-3. 🤖 Prise en charge de l'intégration avec Dify, Alibaba Cloud Bailian, Coze et autres plateformes d'agents.
-4. 🌐 Multi-plateforme : QQ, WeChat Work, Feishu, DingTalk, Comptes officiels WeChat, Telegram, Slack, et [plus encore](#plateformes-de-messagerie-prises-en-charge).
-5. 📦 Extensions de plugins avec près de 800 plugins disponibles pour une installation en un clic.
-6. 💻 Support WebUI.
-7. 🌐 Support de l'internationalisation (i18n).
+2. ✨ Dialogue avec de grands modèles d'IA, multimodal, Agent, MCP, Skills, Base de connaissances, Paramétrage de personnalité, compression automatique des dialogues.
+3. 🤖 Prise en charge de l'accès aux plateformes d'Agents telles que Dify, Alibaba Cloud Bailian, Coze, etc.
+4. 🌐 Multiplateforme : supporte QQ, WeChat Enterprise, Feishu, DingTalk, Comptes officiels WeChat, Telegram, Slack et [plus encore](#plateformes-de-messagerie-prises-en-charge).
+5. 📦 Extension par plugins, avec plus de 1000 plugins déjà disponibles pour une installation en un clic.
+6. 🛡️ Environnement isolé [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) : exécution sécurisée de code, appels Shell et réutilisation des ressources au niveau de la session.
+7. 💻 Support WebUI.
+8. 🌈 Support Web ChatUI, avec sandbox d'agent intégrée, recherche web, etc.
+9. 🌐 Support de l'internationalisation (i18n).
+
+
+
+
+
+
💙 Jeux de rôle & Accompagnement émotionnel
+
✨ Agent proactif
+
🚀 Capacités agentiques générales
+
🧩 1000+ Plugins de communauté
+
+
+
+
+
+
+
+
## Démarrage rapide
@@ -61,9 +79,20 @@ Veuillez consulter la documentation officielle : [Déployer AstrBot avec Docker]
#### Déploiement uv
```bash
-uvx astrbot
+uv tool install astrbot
+astrbot
```
+#### Application de bureau (Tauri)
+
+Dépôt de l'application de bureau : [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop).
+
+Prend en charge plusieurs architectures système, installation directe, prête à l'emploi. La solution de déploiement de bureau en un clic la plus adaptée aux débutants. Non recommandée pour les serveurs.
+
+#### Déploiement en un clic avec le lanceur (AstrBot Launcher)
+
+Déploiement rapide et solution multi-instances, isolation de l'environnement. Accédez au dépôt [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher), trouvez le package d'installation correspondant à votre système sous la dernière version sur la page Releases.
+
#### Déploiement BT-Panel
AstrBot s'est associé à BT-Panel et est maintenant disponible sur leur marketplace.
@@ -115,6 +144,16 @@ uv run main.py
Ou consultez la documentation officielle : [Déployer AstrBot depuis les sources](https://astrbot.app/deploy/astrbot/cli.html).
+#### Installation via le gestionnaire de paquets du système
+
+##### Arch Linux
+
+```bash
+yay -S astrbot-git
+# ou utiliser paru
+paru -S astrbot-git
+```
+
## Plateformes de messagerie prises en charge
**Maintenues officiellement**
@@ -129,8 +168,8 @@ Ou consultez la documentation officielle : [Déployer AstrBot depuis les sources
- Discord
- Satori
- Misskey
+- LINE
- WhatsApp (Bientôt disponible)
-- LINE (Bientôt disponible)
**Maintenues par la communauté**
@@ -153,7 +192,7 @@ Ou consultez la documentation officielle : [Déployer AstrBot depuis les sources
- [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74)
- [302.AI](https://share.302.ai/rr1M3l)
- [TokenPony](https://www.tokenpony.cn/3YPyf)
-- [SiliconFlow](https://docs.siliconflow.cn/cn/usecases/use-siliconcloud-in-astrbot)
+- [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot)
- [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE)
- ModelScope
- OneAPI
@@ -223,7 +262,7 @@ pre-commit install
Un grand merci à tous les contributeurs et développeurs de plugins pour leurs contributions à AstrBot ❤️
-
+
De plus, la naissance de ce projet n'aurait pas été possible sans l'aide des projets open source suivants :
@@ -241,7 +280,12 @@ De plus, la naissance de ce projet n'aurait pas été possible sans l'aide des p
-
+
+
+_La compagnie et la capacité ne devraient jamais être des opposés. Nous souhaitons créer un robot capable à la fois de comprendre les émotions, d'offrir de la présence, et d'accomplir des tâches de manière fiable._
_私は、高性能ですから!_
+
+
+
-中文 |
-English |
-日本語 |
-繁體中文 |
-Français
-
Документация |
Блог |
Дорожная карта |
@@ -38,17 +37,36 @@
AstrBot — это универсальная платформа Agent-чатботов с открытым исходным кодом, которая интегрируется с основными приложениями для обмена мгновенными сообщениями. Она предоставляет надёжную и масштабируемую инфраструктуру разговорного ИИ для частных лиц, разработчиков и команд. Будь то персональный ИИ-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний — AstrBot позволяет быстро создавать готовые к использованию ИИ-приложения в рабочих процессах вашей платформы обмена сообщениями.
-
+
## Основные возможности
-1. 💯 Бесплатно и с открытым исходным кодом.
-2. ✨ ИИ-диалоги с LLM, мультимодальность, Agent, MCP, база знаний, настройки личности.
-3. 🤖 Поддержка интеграции с Dify, Alibaba Cloud Bailian, Coze и другими платформами агентов.
-4. 🌐 Мультиплатформенность: QQ, WeChat Work, Feishu, DingTalk, официальные аккаунты WeChat, Telegram, Slack и [другие](#поддерживаемые-платформы-обмена-сообщениями).
-5. 📦 Расширения плагинов с почти 800 плагинами, доступными для установки в один клик.
-6. 💻 Поддержка WebUI.
-7. 🌐 Поддержка интернационализации (i18n).
+1. 💯 Бесплатно & Открытый исходный код.
+2. ✨ Диалоги с ИИ-моделями, мультимодальность, Agent, MCP, Skills, База знаний, Настройка личности, автоматическое сжатие диалогов.
+3. 🤖 Поддержка интеграции с платформами Agents, такими как Dify, Alibaba Cloud Bailian, Coze и др.
+4. 🌐 Мультиплатформенность: поддержка QQ, WeChat для предприятий, Feishu, DingTalk, публичных аккаунтов WeChat, Telegram, Slack и [других](#Поддерживаемые-платформы-обмена-сообщениями).
+5. 📦 Расширение плагинами: доступно более 1000 плагинов для установки в один клик.
+6. 🛡️ Изолированная среда[Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html): безопасное выполнение любого кода, вызов Shell, повторное использование ресурсов на уровне сессии.
+7. 💻 Поддержка WebUI.
+8. 🌈 Поддержка Web ChatUI: встроенная песочница агента, веб-поиск и др.
+9. 🌐 Поддержка интернационализации (i18n).
+
+
+
+
+
+
💙 Ролевые игры & Эмоциональная поддержка
+
✨ Проактивный Агент (Agent)
+
🚀 Универсальные возможности Агента
+
🧩 1000+ плагинов сообщества
+
+
+
+
+
+
+
+
## Быстрый старт
@@ -61,9 +79,20 @@ AstrBot — это универсальная платформа Agent-чатб
#### Развёртывание uv
```bash
-uvx astrbot
+uv tool install astrbot
+astrbot
```
+#### Десктопное приложение (Tauri)
+
+Репозиторий десктопного приложения: [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop).
+
+Поддерживает различные системные архитектуры, устанавливается напрямую, "из коробки", лучшее настольное решение в один клик для новичков и тех, кто ценит простоту. Не рекомендуется для серверных сценариев.
+
+#### Установка в один клик через лаунчер (AstrBot Launcher)
+
+Быстрое развёртывание и поддержка нескольких экземпляров, изоляция среды. Перейдите в репозиторий [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher), найдите последнюю версию на странице Releases и установите соответствующий пакет для вашей системы.
+
#### Развёртывание BT-Panel
AstrBot в партнёрстве с BT-Panel теперь доступен на их маркетплейсе.
@@ -115,6 +144,16 @@ uv run main.py
Или см. официальную документацию: [Развёртывание AstrBot из исходного кода](https://astrbot.app/deploy/astrbot/cli.html).
+#### Установка через системный пакетный менеджер
+
+##### Arch Linux
+
+```bash
+yay -S astrbot-git
+# или используйте paru
+paru -S astrbot-git
+```
+
## Поддерживаемые платформы обмена сообщениями
**Официально поддерживаемые**
@@ -129,8 +168,9 @@ uv run main.py
- Discord
- Satori
- Misskey
+- LINE
- WhatsApp (Скоро)
-- LINE (Скоро)
+
**Поддерживаемые сообществом**
@@ -153,7 +193,7 @@ uv run main.py
- [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74)
- [302.AI](https://share.302.ai/rr1M3l)
- [TokenPony](https://www.tokenpony.cn/3YPyf)
-- [SiliconFlow](https://docs.siliconflow.cn/cn/usecases/use-siliconcloud-in-astrbot)
+- [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot)
- [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE)
- ModelScope
- OneAPI
@@ -223,7 +263,7 @@ pre-commit install
Особая благодарность всем контрибьюторам и разработчикам плагинов за их вклад в AstrBot ❤️
-
+
Кроме того, рождение этого проекта было бы невозможно без помощи следующих проектов с открытым исходным кодом:
@@ -235,13 +275,19 @@ pre-commit install
> [!TIP]
> Если этот проект помог вам в жизни или работе, или если вас интересует его будущее развитие, пожалуйста, поставьте проекту звезду. Это движущая сила поддержки этого проекта с открытым исходным кодом <3
+
[](https://star-history.com/#astrbotdevs/astrbot&Date)
-
+
+
+_Сопровождение и способности никогда не должны быть противоположностями. Мы стремимся создать робота, который сможет как понимать эмоции, оказывать душевную поддержку, так и надёжно выполнять работу._
_私は、高性能ですから!_
+
+
+
-AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.
+AstrBot is an open-source, one-stop Agentic personal and group chat assistant. It can be deployed on dozens of mainstream instant messaging platforms such as QQ, Telegram, WeCom, Lark (Feishu), DingTalk, Slack, etc. It also features a built-in lightweight ChatUI similar to OpenWebUI, creating a reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether it's a personal AI companion, intelligent customer service, automated assistant, or enterprise knowledge base, AstrBot enables you to quickly build AI applications within the workflow of your instant messaging platforms.
-
+
## Key Features
1. 💯 Free & Open Source.
-2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
-3. 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
-4. 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and [more](#supported-messaging-platforms).
-5. 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
-6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) for isolated, safe execution of code, shell calls, and session-level resource reuse.
-7. 💻 WebUI Support.
-8. 🌈 Web ChatUI Support with built-in agent sandbox and web search.
-9. 🌐 Internationalization (i18n) Support.
+2. ✨ AI LLM Chat, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona, Auto-summarization.
+3. 🤖 Supports integration with Agent platforms like Dify, Aliyun Bailian, Coze, etc.
+4. 🌐 Multi-platform support: QQ, WeCom, Lark, DingTalk, WeChat Official Account, Telegram, Slack, and [more](#supported-messaging-platforms).
+5. 📦 Plugin Extension: 1000+ plugins available for one-click installation.
+6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html): An isolated environment to safely execute code, call Shell, and reuse session-level resources.
+7. 💻 WebUI support.
+8. 🌈 Web ChatUI support: ChatUI features built-in proxy sandbox, web search, etc.
+9. 🌐 Internationalization (i18n) support.
-
💙 Role-playing & Emotional Companionship
+
💙 Roleplay & Companionship
✨ Proactive Agent
🚀 General Agentic Capabilities
🧩 1000+ Community Plugins
@@ -73,18 +73,18 @@ AstrBot is an open-source all-in-one Agent chatbot platform that integrates with
### One-Click Deployment
-For users who want to quickly experience AstrBot, are familiar with command-line usage, and can install a `uv` environment on their own, we recommend the `uv` one-click deployment method ⚡️:
+For users who want to quickly experience AstrBot, are familiar with the command line, and can install the `uv` environment themselves, we recommend using the `uv` one-click deployment method ⚡️.
```bash
uv tool install astrbot
-astrbot init # Only execute this command for the first time to initialize the environment
+astrbot init # Run this command only for the first time to initialize the environment
astrbot run
```
-> Requires [uv](https://docs.astral.sh/uv/) to be installed.
+> Requires [uv](https://docs.astral.sh/uv/) installation.
> [!NOTE]
-> For macOS user: due to macOS security checks, the first run of the `astrbot` command may take longer (about 10-20s).
+> For macOS users: Due to macOS security checks, running the `astrbot` command for the first time may take a long time (about 10-20 seconds).
Update `astrbot`:
@@ -94,134 +94,140 @@ uv tool upgrade astrbot
### Docker Deployment
-For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose.
+For users familiar with containers who prefer a more stable deployment method suitable for production environments, we recommend using Docker / Docker Compose to deploy AstrBot.
-Please refer to the official documentation: [Deploy AstrBot with Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+Please refer to the official documentation [Deploy AstrBot with Docker](https://astrbot.app/deploy/astrbot/docker.html).
### Deploy on RainYun
-For users who want one-click deployment and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service ☁️:
+For users who want to deploy AstrBot with one click and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service ☁️:
[](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
-### Desktop Application Deployment
+### Desktop Client Deployment
-For users who want to use AstrBot on desktop and mainly use ChatUI, we recommend AstrBot App.
+For users who wish to use AstrBot on the desktop and primarily use ChatUI as the entry point, we recommend using the AstrBot App.
-Visit [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) to download and install; this method is designed for desktop usage and is not recommended for server scenarios.
+Go to [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) to download and install; this method is intended for desktop use and is not recommended for server scenarios.
### Launcher Deployment
-For desktop users who also want fast deployment and isolated multi-instance usage, we recommend AstrBot Launcher.
+Also for desktop use, for users who want to quickly deploy and achieve environment isolation for multiple instances, we recommend AstrBot Launcher.
-Visit [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) to download and install.
+Go to [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) to download and install.
### Deploy on Replit
-Replit deployment is maintained by the community and is suitable for online demos and lightweight trials.
+The Replit deployment is maintained by the community and is suitable for online demonstrations and lightweight trial scenarios.
[](https://repl.it/github/AstrBotDevs/AstrBot)
### AUR
-AUR deployment targets Arch Linux users who prefer installing AstrBot through the system package workflow.
+The AUR method is intended for Arch Linux users who wish to install AstrBot via the system package manager.
-Run the command below to install `astrbot-git`, then start AstrBot in your local environment.
+Run the following command in the terminal to install the `astrbot-git` package. Once installed, you can start using it.
```bash
yay -S astrbot-git
```
-**More deployment methods**
+**More Deployment Methods**
-If you need panel-based management or deeper customization, see [BT-Panel Deployment](https://astrbot.app/deploy/astrbot/btpanel.html) for BT Panel app-store setup, [1Panel Deployment](https://astrbot.app/deploy/astrbot/1panel.html) for 1Panel app-market deployment, [CasaOS Deployment](https://astrbot.app/deploy/astrbot/casaos.html) for NAS/home-server visual deployment, and [Manual Deployment](https://astrbot.app/deploy/astrbot/cli.html) for fully custom source-based installation with `uv`.
+If you need a panel-based or highly customized deployment, please refer to [BT Panel](https://astrbot.app/deploy/astrbot/btpanel.html) (BT Panel App Store installation), [1Panel](https://astrbot.app/deploy/astrbot/1panel.html) (1Panel App Store installation), [CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) (NAS / Home Server visual deployment), and [Manual Deployment](https://astrbot.app/deploy/astrbot/cli.html) (Full custom installation based on source code and `uv`).
## Supported Messaging Platforms
-Connect AstrBot to your favorite chat platform.
+Connect AstrBot to your favorite chat platforms.
| Platform | Maintainer |
|---------|---------------|
-| QQ | Official |
-| OneBot v11 protocol implementation | Official |
-| Telegram | Official |
-| Wecom & Wecom AI Bot | Official |
-| WeChat Official Accounts | Official |
-| Feishu (Lark) | Official |
-| DingTalk | Official |
-| Slack | Official |
-| Discord | Official |
-| LINE | Official |
-| Satori | Official |
-| Misskey | Official |
-| WhatsApp (Coming Soon) | Official |
-| [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Community |
-| [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter) | Community |
-| [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Community |
-
-## Supported Model Services
-
-| Service | Type |
+| **QQ** | Official |
+| **OneBot v11** | Official |
+| **Telegram** | Official |
+| **WeCom App & Bot** | Official |
+| **WeChat Customer Service & Official Account** | Official |
+| **Lark (Feishu)** | Official |
+| **DingTalk** | Official |
+| **Slack** | Official |
+| **Discord** | Official |
+| **LINE** | Official |
+| **Satori** | Official |
+| **Misskey** | Official |
+| **Whatsapp (Coming Soon)** | Official |
+| [**Matrix**](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Community |
+| [**KOOK**](https://github.com/wuyan1003/astrbot_plugin_kook_adapter) | Community |
+| [**VoceChat**](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Community |
+
+## Supported Model Providers
+
+| Provider | Type |
|---------|---------------|
-| OpenAI and Compatible Services | LLM Services |
-| Anthropic | LLM Services |
-| Google Gemini | LLM Services |
-| Moonshot AI | LLM Services |
-| Zhipu AI | LLM Services |
-| DeepSeek | LLM Services |
-| Ollama (Self-hosted) | LLM Services |
-| LM Studio (Self-hosted) | LLM Services |
-| [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM Services (API Gateway, supports all models) |
-| [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM Services |
-| [302.AI](https://share.302.ai/rr1M3l) | LLM Services |
-| [TokenPony](https://www.tokenpony.cn/3YPyf) | LLM Services |
-| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM Services |
-| [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE) | LLM Services |
-| ModelScope | LLM Services |
-| OneAPI | LLM Services |
-| Dify | LLMOps Platforms |
-| Alibaba Cloud Bailian Applications | LLMOps Platforms |
-| Coze | LLMOps Platforms |
-| OpenAI Whisper | Speech-to-Text Services |
-| SenseVoice | Speech-to-Text Services |
-| OpenAI TTS | Text-to-Speech Services |
-| Gemini TTS | Text-to-Speech Services |
-| GPT-Sovits-Inference | Text-to-Speech Services |
-| GPT-Sovits | Text-to-Speech Services |
-| FishAudio | Text-to-Speech Services |
-| Edge TTS | Text-to-Speech Services |
-| Alibaba Cloud Bailian TTS | Text-to-Speech Services |
-| Azure TTS | Text-to-Speech Services |
-| Minimax TTS | Text-to-Speech Services |
-| Volcano Engine TTS | Text-to-Speech Services |
-
-## ❤️ Sponsors
-
-
-
-
-
-
-## ❤️ Contributing
-
-Issues and Pull Requests are always welcome! Feel free to submit your changes to this project :)
+| Custom | Any OpenAI API compatible service |
+| OpenAI | LLM |
+| Anthropic | LLM |
+| Google Gemini | LLM |
+| Moonshot AI | LLM |
+| Zhipu AI | LLM |
+| DeepSeek | LLM |
+| Ollama (Local) | LLM |
+| LM Studio (Local) | LLM |
+| [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM (API Gateway, supports all models) |
+| [Uyun AI](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM (API Gateway, supports all models) |
+| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM (API Gateway, supports all models) |
+| [PPIO](https://ppio.com/user/register?invited_by=AIOONE) | LLM (API Gateway, supports all models) |
+| [302.AI](https://share.302.ai/rr1M3l) | LLM (API Gateway, supports all models)|
+| [TokenPony](https://www.tokenpony.cn/3YPyf) | LLM (API Gateway, supports all models)|
+| ModelScope | LLM |
+| OneAPI | LLM |
+| Dify | LLMOps Platform |
+| Aliyun Bailian | LLMOps Platform |
+| Coze | LLMOps Platform |
+| OpenAI Whisper | Speech-to-Text |
+| SenseVoice | Speech-to-Text |
+| OpenAI TTS | Text-to-Speech |
+| Gemini TTS | Text-to-Speech |
+| GPT-Sovits-Inference | Text-to-Speech |
+| GPT-Sovits | Text-to-Speech |
+| FishAudio | Text-to-Speech |
+| Edge TTS | Text-to-Speech |
+| Aliyun Bailian TTS | Text-to-Speech |
+| Azure TTS | Text-to-Speech |
+| Minimax TTS | Text-to-Speech |
+| Volcengine TTS | Text-to-Speech |
+
+## ❤️ Contribution
+
+Issues and Pull Requests are welcome! Just submit your changes to this project :)
### How to Contribute
-You can contribute by reviewing issues or helping with pull request reviews. Any issues or PRs are welcome to encourage community participation. Of course, these are just suggestions—you can contribute in any way you like. For adding new features, please discuss through an Issue first.
+You can contribute by viewing issues or helping to review PRs (Pull Requests). Any issue or PR is welcome to participate in promoting community contributions. Of course, these are just suggestions, and you can contribute in any way. For the addition of new features, please discuss via Issue first.
+It is recommended to merge functional PRs into the `dev` branch, which will be merged into the main branch and released as a new version after testing modifications.
### Development Environment
-AstrBot uses `ruff` for code formatting and linting.
+AstrBot uses `ruff` for code formatting and checking.
```bash
git clone https://github.com/AstrBotDevs/AstrBot
-pip install pre-commit
+git switch dev # Switch to dev branch
+pip install pre-commit # or uv tool install pre-commit
pre-commit install
```
-
-
-## 🌍 Community
+It is recommended to use `uv` for local installation and testing:
+```bash
+uv tool install -e . --force
+astrbot init
+astrbot run
+```
+Frontend debugging:
+```bash
+astrbot run --backend-only
+cd dashboard
+bun install # or pnpm, etc.
+bun dev
+```
### QQ Groups
@@ -233,30 +239,39 @@ pre-commit install
- Group 6: 753075035
- Group 7: 743746109
- Group 8: 1030353265
+- Developer Group (Casual Chat): 975206796
+- Developer Group (Official): 1039761811
-- Developer Group(Chit-chat): 975206796
-- Developer Group(Formal): 1039761811
+### Discord Channel
-### Discord Server
-
-
+- [Discord](https://discord.gg/hAVk6tgV36)
## ❤️ Special Thanks
-Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
+Special thanks to all Contributors and Plugin Developers for their contributions to AstrBot ❤️
-Additionally, the birth of this project would not have been possible without the help of the following open-source projects:
+In addition, the birth of this project cannot be separated from the help of the following open-source projects:
+
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - The great cat framework
-- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - The amazing cat framework
+Open source project friendly links:
+
+- [NoneBot2](https://github.com/nonebot/nonebot2) - Excellent Python asynchronous ChatBot framework
+- [Koishi](https://github.com/koishijs/koishi) - Excellent Node.js ChatBot framework
+- [MaiBot](https://github.com/Mai-with-u/MaiBot) - Excellent anthropomorphic AI ChatBot
+- [nekro-agent](https://github.com/KroMiose/nekro-agent) - Excellent Agent ChatBot
+- [LangBot](https://github.com/langbot-app/LangBot) - Excellent multi-platform AI ChatBot
+- [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Excellent multi-platform AI ChatBot Koishi plugin
+- [Operit AI](https://github.com/AAswordman/Operit) - Excellent AI intelligent assistant Android APP
## ⭐ Star History
> [!TIP]
-> If this project has helped you in your life or work, or if you're interested in its future development, please give the project a Star. It's the driving force behind maintaining this open-source project <3
+> If this project has been helpful to your life/work, or if you are interested in the future development of this project, please give the project a Star. This is our motivation to maintain this open-source project <3
@@ -266,9 +281,10 @@ Additionally, the birth of this project would not have been possible without the
-_Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks._
+_Companionship and capability should never be opposites. We hope to create a robot that can both understand emotions, provide companionship, and reliably complete tasks._
_私は、高性能ですから!_
-
+
+
\ No newline at end of file
diff --git a/README_fr.md b/README_fr.md
index 98e7f9955c..95e8042e96 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -2,14 +2,12 @@
-Documentation |
-Blog |
-Feuille de route |
-Signaler un problème
-Email Support
-
-
-AstrBot est une plateforme de chatbot Agent tout-en-un open source qui s'intègre aux principales applications de messagerie instantanée. Elle fournit une infrastructure d'IA conversationnelle fiable et évolutive pour les particuliers, les développeurs et les équipes. Que vous construisiez un compagnon IA personnel, un service client intelligent, un assistant d'automatisation ou une base de connaissances d'entreprise, AstrBot vous permet de créer rapidement des applications d'IA prêtes pour la production dans les flux de travail de votre plateforme de messagerie.
+
-
+ Accueil |
+ Documentation |
+ Blog |
+ Feuille de route |
+ Problèmes
+ Email
-## Fonctionnalités principales
+
-1. 💯 Gratuit & Open Source.
-2. ✨ Dialogue avec de grands modèles d'IA, multimodal, Agent, MCP, Skills, Base de connaissances, Paramétrage de personnalité, compression automatique des dialogues.
-3. 🤖 Prise en charge de l'accès aux plateformes d'Agents telles que Dify, Alibaba Cloud Bailian, Coze, etc.
-4. 🌐 Multiplateforme : supporte QQ, WeChat Enterprise, Feishu, DingTalk, Comptes officiels WeChat, Telegram, Slack et [plus encore](#plateformes-de-messagerie-prises-en-charge).
-5. 📦 Extension par plugins, avec plus de 1000 plugins déjà disponibles pour une installation en un clic.
-6. 🛡️ Environnement isolé [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) : exécution sécurisée de code, appels Shell et réutilisation des ressources au niveau de la session.
-7. 💻 Support WebUI.
-8. 🌈 Support Web ChatUI, avec sandbox d'agent intégrée, recherche web, etc.
-9. 🌐 Support de l'internationalisation (i18n).
+ AstrBot est un assistant de discussion personnel et de groupe Agentic open-source tout-en-un, déployable sur des dizaines de logiciels de messagerie instantanée grand public tels que QQ, Telegram, WeCom (Entreprise WeChat), Lark (Feishu), DingTalk, Slack, etc. Il intègre également une interface de chat légère (ChatUI) similaire à OpenWebUI, créant une infrastructure d'IA conversationnelle fiable et évolutive pour les particuliers, les développeurs et les équipes. Qu'il s'agisse d'un compagnon IA personnel, d'un service client intelligent, d'un assistant d'automatisation ou d'une base de connaissances d'entreprise, AstrBot vous permet de construire rapidement des applications IA au sein du flux de travail de votre plateforme de messagerie instantanée.
-
+ 
-
-
-
💙 Jeux de rôle & Accompagnement émotionnel
-
✨ Agent proactif
-
🚀 Capacités agentiques générales
-
🧩 1000+ Plugins de communauté
-
-
-
-
-
-
-
-
+ ## Principales Fonctionnalités
-## Démarrage rapide
+ 1. 💯 Gratuit & Open Source.
+ 2. ✨ Conversation IA LLM, Multimodal, Agent, MCP, Skills, Base de connaissances, Personnalité, Compression automatique du dialogue.
+ 3. 🤖 Prise en charge de l'intégration avec des plateformes d'agents telles que Dify, Aliyun Bailian, Coze, etc.
+ 4. 🌐 Multi-plateforme, prend en charge QQ, WeCom, Lark, DingTalk, Comptes Officiels WeChat, Telegram, Slack et [plus](#plateformes-de-messagerie-prises-en-charge).
+ 5. 📦 Extension de plugins, plus de 1000 plugins disponibles pour une installation en un clic.
+ 6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) Environnement isolé pour exécuter du code en toute sécurité, appeler le Shell et réutiliser les ressources au niveau de la session.
+ 7. 💻 Support WebUI.
+ 8. 🌈 Support Web ChatUI, ChatUI intègre un bac à sable d'agent, une recherche Web, etc.
+ 9. 🌐 Support de l'internationalisation (i18n).
-### Déploiement en un clic
+
-Pour les utilisateurs qui veulent découvrir AstrBot rapidement, qui sont familiers avec la ligne de commande et peuvent installer eux-mêmes l'environnement `uv`, nous recommandons la méthode de déploiement en un clic avec `uv` ⚡️ :
+
+
+
💙 Jeu de rôle & Compagnonnage
+
✨ Agent Proactif
+
🚀 Capacités Agentic Générales
+
🧩 1000+ Plugins Communautaires
+
+
+
+
+
+
+
+
-```bash
-uv tool install astrbot
-astrbot init # Exécutez cette commande uniquement la première fois pour initialiser l'environnement
-astrbot run
-```
+ ## Démarrage Rapide
-> [uv](https://docs.astral.sh/uv/) doit être installé.
+ ### Déploiement en un clic
-> [!NOTE]
-> Pour les utilisateurs macOS : en raison des vérifications de sécurité de macOS, la première exécution de la commande `astrbot` peut prendre plus de temps (environ 10-20s).
+ Pour les utilisateurs qui souhaitent expérimenter rapidement AstrBot, qui sont familiers avec la ligne de commande et capables d'installer l'environnement `uv` par eux-mêmes, nous recommandons la méthode de déploiement en un clic `uv` ⚡️.
-Mettre à jour `astrbot` :
+ ```bash
+ uv tool install astrbot
+ astrbot init # Exécutez cette commande uniquement la première fois pour initialiser l'environnement
+ astrbot run
+ ```
-```bash
-uv tool upgrade astrbot
-```
+ > Nécessite l'installation de [uv](https://docs.astral.sh/uv/).
-### Déploiement Docker
+ > [!NOTE]
+ > Pour les utilisateurs de macOS : en raison des vérifications de sécurité de macOS, la première exécution de la commande `astrbot` peut prendre un certain temps (environ 10-20 secondes).
-Pour les utilisateurs familiers avec les conteneurs et qui souhaitent une méthode plus stable et adaptée à la production, nous recommandons de déployer AstrBot avec Docker / Docker Compose.
+ Mettre à jour `astrbot` :
-Veuillez consulter la documentation officielle [Déployer AstrBot avec Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+ ```bash
+ uv tool upgrade astrbot
+ ```
-### Déployer sur RainYun
+ ### Déploiement Docker
-Pour les utilisateurs qui souhaitent déployer AstrBot en un clic sans gérer le serveur eux-mêmes, nous recommandons le service de déploiement cloud en un clic de RainYun ☁️ :
+ Pour les utilisateurs familiers avec les conteneurs et souhaitant une méthode de déploiement plus stable et adaptée aux environnements de production, nous recommandons d'utiliser Docker / Docker Compose pour déployer AstrBot.
-[](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
+ Veuillez vous référer à la documentation officielle [Déployer AstrBot avec Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
-### Déploiement de l'application de bureau
+ ### Déploiement sur RainYun
-Pour les utilisateurs qui veulent utiliser AstrBot sur desktop et passer principalement par ChatUI, nous recommandons AstrBot App.
+ Pour les utilisateurs qui souhaitent déployer AstrBot en un clic et ne veulent pas gérer de serveurs eux-mêmes, nous recommandons le service de déploiement cloud en un clic de RainYun ☁️ :
-Accédez à [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) pour télécharger et installer l'application ; cette méthode est conçue pour un usage desktop et n'est pas recommandée pour les scénarios serveur.
+ [](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
-### Déploiement avec le lanceur
+ ### Déploiement Client de Bureau
-Également sur desktop, pour les utilisateurs qui souhaitent un déploiement rapide avec isolation d'environnement et multi-instances, nous recommandons AstrBot Launcher.
+ Pour les utilisateurs souhaitant utiliser AstrBot sur ordinateur et utilisant principalement ChatUI comme point d'entrée, nous recommandons AstrBot App.
-Accédez à [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) pour télécharger et installer.
+ Allez sur [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) pour télécharger et installer ; cette méthode est destinée à un usage sur ordinateur de bureau et n'est pas recommandée pour les scénarios serveur.
-### Déployer sur Replit
+ ### Déploiement via Lanceur
-Le déploiement sur Replit est maintenu par la communauté et convient aux démonstrations en ligne et aux essais légers.
+ Toujours sur ordinateur, pour les utilisateurs souhaitant déployer rapidement et isoler l'environnement pour plusieurs instances, nous recommandons AstrBot Launcher.
-[](https://repl.it/github/AstrBotDevs/AstrBot)
+ Allez sur [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) pour télécharger et installer.
-### AUR
+ ### Déploiement sur Replit
-Le mode AUR s'adresse aux utilisateurs Arch Linux qui préfèrent installer AstrBot via le gestionnaire de paquets système.
+ Le déploiement Replit est maintenu par la communauté et convient aux démonstrations en ligne et aux essais légers.
-Exécutez la commande ci-dessous pour installer `astrbot-git`, puis lancez AstrBot localement.
+ [](https://repl.it/github/AstrBotDevs/AstrBot)
-```bash
-yay -S astrbot-git
-```
+ ### AUR
-**Autres méthodes de déploiement**
+ La méthode AUR est destinée aux utilisateurs d'Arch Linux qui souhaitent installer AstrBot via le gestionnaire de paquets du système.
+
+ Exécutez la commande ci-dessous dans le terminal pour installer le paquet `astrbot-git`, une fois l'installation terminée, vous pouvez le lancer.
+
+ ```bash
+ yay -S astrbot-git
+ ```
-Si vous avez besoin d'une gestion par panneau ou d'une personnalisation plus poussée, consultez [Déploiement BT-Panel](https://astrbot.app/deploy/astrbot/btpanel.html) pour une installation via BT Panel, [Déploiement 1Panel](https://astrbot.app/deploy/astrbot/1panel.html) pour le marketplace 1Panel, [Déploiement CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) pour un déploiement visuel sur NAS/serveur domestique, et [Déploiement manuel](https://astrbot.app/deploy/astrbot/cli.html) pour une installation complète depuis les sources avec `uv`.
+ **Plus de méthodes de déploiement**
-## Plateformes de messagerie prises en charge
+ Si vous avez besoin d'une gestion par panneau ou d'un déploiement plus personnalisé, veuillez consulter [BT Panel](https://astrbot.app/deploy/astrbot/btpanel.html) (Installation via le magasin d'applications BT Panel), [1Panel](https://astrbot.app/deploy/astrbot/1panel.html) (Installation via le magasin d'applications 1Panel), [CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) (Déploiement visuel NAS / Serveur domestique) et [Déploiement Manuel](https://astrbot.app/deploy/astrbot/cli.html) (Installation entièrement personnalisée basée sur le code source et `uv`).
+
+ ## Plateformes de messagerie prises en charge
+
+ Connectez AstrBot à votre plateforme de chat préférée.
+
+ | Plateforme | Mainteneur |
+ |---------|---------------|
+ | **QQ** | Officiel |
+ | **OneBot v11** | Officiel |
+ | **Telegram** | Officiel |
+ | **App WeCom & Bot Intelligent** | Officiel |
+ | **Service Client WeChat & Compte Officiel** | Officiel |
+ | **Feishu (Lark)** | Officiel |
+ | **DingTalk** | Officiel |
+ | **Slack** | Officiel |
+ | **Discord** | Officiel |
+ | **LINE** | Officiel |
+ | **Satori** | Officiel |
+ | **Misskey** | Officiel |
+ | **Whatsapp (Bientôt disponible)** | Officiel |
+ | [**Matrix**](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Communauté |
+ | [**KOOK**](https://github.com/wuyan1003/astrbot_plugin_kook_adapter) | Communauté |
+ | [**VoceChat**](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Communauté |
-Connectez AstrBot à vos plateformes de chat préférées.
+ ## Fournisseurs de modèles pris en charge
-| Plateforme | Maintenance |
-|---------|---------------|
-| QQ | Officielle |
-| Implémentation du protocole OneBot v11 | Officielle |
-| Telegram | Officielle |
-| Application WeChat Work & Bot intelligent WeChat Work | Officielle |
-| Service client WeChat & Comptes officiels WeChat | Officielle |
-| Feishu (Lark) | Officielle |
-| DingTalk | Officielle |
-| Slack | Officielle |
-| Discord | Officielle |
-| LINE | Officielle |
-| Satori | Officielle |
-| Misskey | Officielle |
-| WhatsApp (Bientôt disponible) | Officielle |
-| [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Communauté |
-| [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter) | Communauté |
-| [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Communauté |
+ | Fournisseur | Type |
+ |---------|---------------|
+ | Personnalisé | Tout service compatible OpenAI API |
+ | OpenAI | LLM |
+ | Anthropic | LLM |
+ | Google Gemini | LLM |
+ | Moonshot AI | LLM |
+ | Zhipu AI | LLM |
+ | DeepSeek | LLM |
+ | Ollama (Local) | LLM |
+ | LM Studio (Local) | LLM |
+ | [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM (Passerelle API, supporte tous les modèles) |
+ | [Uyun AI](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM (Passerelle API, supporte tous les modèles) |
+ | [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM (Passerelle API, supporte tous les modèles) |
+ | [PPIO](https://ppio.com/user/register?invited_by=AIOONE) | LLM (Passerelle API, supporte tous les modèles) |
+ | [302.AI](https://share.302.ai/rr1M3l) | LLM (Passerelle API, supporte tous les modèles)|
+ | [TokenPony](https://www.tokenpony.cn/3YPyf) | LLM (Passerelle API, supporte tous les modèles)|
+ | ModelScope | LLM |
+ | OneAPI | LLM |
+ | Dify | Plateforme LLMOps |
+ | Aliyun Bailian | Plateforme LLMOps |
+ | Coze | Plateforme LLMOps |
+ | OpenAI Whisper | Synthèse vocale (STT) |
+ | SenseVoice | Synthèse vocale (STT) |
+ | OpenAI TTS | Synthèse vocale (TTS) |
+ | Gemini TTS | Synthèse vocale (TTS) |
+ | GPT-Sovits-Inference | Synthèse vocale (TTS) |
+ | GPT-Sovits | Synthèse vocale (TTS) |
+ | FishAudio | Synthèse vocale (TTS) |
+ | Edge TTS | Synthèse vocale (TTS) |
+ | Aliyun Bailian TTS | Synthèse vocale (TTS) |
+ | Azure TTS | Synthèse vocale (TTS) |
+ | Minimax TTS | Synthèse vocale (TTS) |
+ | Volcengine TTS | Synthèse vocale (TTS) |
-## Services de modèles pris en charge
+ ## ❤️ Contribution
-| Service | Type |
-|---------|---------------|
-| OpenAI et services compatibles | Services LLM |
-| Anthropic | Services LLM |
-| Google Gemini | Services LLM |
-| Moonshot AI | Services LLM |
-| Zhipu AI | Services LLM |
-| DeepSeek | Services LLM |
-| Ollama (Auto-hébergé) | Services LLM |
-| LM Studio (Auto-hébergé) | Services LLM |
-| [AIHubMix](https://aihubmix.com/?aff=4bfH) | Services LLM (Passerelle API, prend en charge tous les modèles) |
-| [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | Services LLM |
-| [302.AI](https://share.302.ai/rr1M3l) | Services LLM |
-| [TokenPony](https://www.tokenpony.cn/3YPyf) | Services LLM |
-| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | Services LLM |
-| [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE) | Services LLM |
-| ModelScope | Services LLM |
-| OneAPI | Services LLM |
-| Dify | Plateformes LLMOps |
-| Applications Alibaba Cloud Bailian | Plateformes LLMOps |
-| Coze | Plateformes LLMOps |
-| OpenAI Whisper | Services de reconnaissance vocale |
-| SenseVoice | Services de reconnaissance vocale |
-| OpenAI TTS | Services de synthèse vocale |
-| Gemini TTS | Services de synthèse vocale |
-| GPT-Sovits-Inference | Services de synthèse vocale |
-| GPT-Sovits | Services de synthèse vocale |
-| FishAudio | Services de synthèse vocale |
-| Edge TTS | Services de synthèse vocale |
-| Alibaba Cloud Bailian TTS | Services de synthèse vocale |
-| Azure TTS | Services de synthèse vocale |
-| Minimax TTS | Services de synthèse vocale |
-| Volcano Engine TTS | Services de synthèse vocale |
+ Les Issues et Pull Requests sont les bienvenus ! Soumettez simplement vos modifications à ce projet :)
-## ❤️ Contribuer
+ ### Comment contribuer
-Les Issues et Pull Requests sont toujours les bienvenues ! N'hésitez pas à soumettre vos modifications à ce projet :)
+ Vous pouvez contribuer en examinant les problèmes ou en aidant à examiner les PR (Pull Requests). Tout problème ou PR est le bienvenu pour encourager la participation de la communauté. Bien sûr, ce ne sont que des suggestions, vous pouvez contribuer de n'importe quelle manière. Pour l'ajout de nouvelles fonctionnalités, veuillez d'abord en discuter via une Issue.
+ Il est recommandé de fusionner les PR fonctionnels dans la branche `dev`, qui sera fusionnée dans la branche principale et publiée en tant que nouvelle version après les tests de modification.
-### Comment contribuer
+ ### Environnement de développement
-Vous pouvez contribuer en examinant les issues ou en aidant à la revue des pull requests. Toutes les issues ou PRs sont les bienvenues pour encourager la participation de la communauté. Bien sûr, ce ne sont que des suggestions - vous pouvez contribuer de la manière que vous souhaitez. Pour l'ajout de nouvelles fonctionnalités, veuillez d'abord en discuter via une Issue.
+ AstrBot utilise `ruff` pour le formatage et la vérification du code.
-### Environnement de développement
+ ```bash
+ git clone https://github.com/AstrBotDevs/AstrBot
+ git switch dev # Basculer vers la branche de développement
+ pip install pre-commit # ou uv tool install pre-commit
+ pre-commit install
+ ```
+ Il est recommandé d'utiliser uv pour l'installation locale et les tests
+ ```bash
+ uv tool install -e . --force
+ astrbot init
+ astrbot run
+ ```
+ Débogage frontend
+ ```bash
+ astrbot run --backend-only
+ cd dashboard
+ bun install # ou pnpm, etc.
+ bun dev
+ ```
+
+ ### Groupes QQ
+
+ - Groupe 9 : 1076659624 (Nouveau)
+ - Groupe 10 : 1078079676 (Nouveau)
+ - Groupe 1 : 322154837
+ - Groupe 3 : 630166526
+ - Groupe 5 : 822130018
+ - Groupe 6 : 753075035
+ - Groupe 7 : 743746109
+ - Groupe 8 : 1030353265
+ - Groupe de développeurs (Discussion informelle) : 975206796
+ - Groupe de développeurs (Officiel) : 1039761811
+
+ ### Canal Discord
+
+ - [Discord](https://discord.gg/hAVk6tgV36)
+
+ ## ❤️ Remerciements Spéciaux
+
+ Merci tout particulièrement à tous les Contributeurs et développeurs de plugins pour leurs contributions à AstrBot ❤️
+
+
+
+
+
+ De plus, la naissance de ce projet n'aurait pas été possible sans l'aide des projets open-source suivants :
+
+ - [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Le formidable framework chat
+
+ Liens amicaux vers des projets open source :
+
+ - [NoneBot2](https://github.com/nonebot/nonebot2) - Excellent framework de ChatBot asynchrone Python
+ - [Koishi](https://github.com/koishijs/koishi) - Excellent framework de ChatBot Node.js
+ - [MaiBot](https://github.com/Mai-with-u/MaiBot) - Excellent ChatBot IA anthropomorphique
+ - [nekro-agent](https://github.com/KroMiose/nekro-agent) - Excellent ChatBot Agent
+ - [LangBot](https://github.com/langbot-app/LangBot) - Excellent ChatBot IA multi-plateforme
+ - [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Excellent plugin ChatBot IA multi-plateforme pour Koishi
+ - [Operit AI](https://github.com/AAswordman/Operit) - Excellente application Android d'assistant intelligent IA
+
+ ## ⭐ Star History
+
+ > [!TIP]
+ > Si ce projet vous a aidé dans votre vie / travail, ou si vous êtes intéressé par le développement futur de ce projet, veuillez donner une étoile (Star) au projet, c'est notre motivation pour maintenir ce projet open-source <3
+
+
-AstrBot utilise `ruff` pour le formatage et le linting du code.
+ [](https://star-history.com/#astrbotdevs/astrbot&Date)
-```bash
-git clone https://github.com/AstrBotDevs/AstrBot
-pip install pre-commit
-pre-commit install
-```
+
-## 🌍 Communauté
+
-### Groupes QQ
+ _La compagnie et la capacité ne devraient jamais être opposées. Nous espérons créer un robot capable à la fois de comprendre les émotions, d'offrir de la compagnie, et d'accomplir des tâches de manière fiable._
-- Groupe 1 : 322154837
-- Groupe 3 : 630166526
-- Groupe 5 : 822130018
-- Groupe 6 : 753075035
-- Groupe développeurs : 975206796
-- Groupe développeurs (officiel) : 1039761811
+ _私は、高性能ですから!_
-### Serveur Discord
-
-
-
-## ❤️ Remerciements spéciaux
-
-Un grand merci à tous les contributeurs et développeurs de plugins pour leurs contributions à AstrBot ❤️
-
-
-
-
-
-De plus, la naissance de ce projet n'aurait pas été possible sans l'aide des projets open source suivants :
-
-- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - L'incroyable framework chat
-
-## ⭐ Historique des étoiles
-
-> [!TIP]
-> Si ce projet vous a aidé dans votre vie ou votre travail, ou si vous êtes intéressé par son développement futur, veuillez donner une étoile au projet. C'est la force motrice derrière la maintenance de ce projet open source <3
-
-
+
-[](https://star-history.com/#astrbotdevs/astrbot&Date)
-
-
-
-
-
-_La compagnie et la capacité ne devraient jamais être des opposés. Nous souhaitons créer un robot capable à la fois de comprendre les émotions, d'offrir de la présence, et d'accomplir des tâches de manière fiable._
-
-_私は、高性能ですから!_
-
-
-
-
+
\ No newline at end of file
diff --git a/README_ja.md b/README_ja.md
index 2b7c43d48c..0b27a7194d 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -2,14 +2,12 @@
\ No newline at end of file
diff --git a/README_ru.md b/README_ru.md
index 29d077b451..380f6b8281 100644
--- a/README_ru.md
+++ b/README_ru.md
@@ -2,13 +2,11 @@
-AstrBot — это универсальная платформа Agent-чатботов с открытым исходным кодом, которая интегрируется с основными приложениями для обмена мгновенными сообщениями. Она предоставляет надёжную и масштабируемую инфраструктуру разговорного ИИ для частных лиц, разработчиков и команд. Будь то персональный ИИ-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний — AstrBot позволяет быстро создавать готовые к использованию ИИ-приложения в рабочих процессах вашей платформы обмена сообщениями.
+AstrBot — это универсальный агентный помощник для личных и групповых чатов с открытым исходным кодом. Он может быть развернут в десятках популярных мессенджеров, таких как QQ, Telegram, WeCom, Lark (Feishu), DingTalk, Slack и других. Кроме того, он имеет встроенный легковесный веб-интерфейс ChatUI, похожий на OpenWebUI, что создает надежную и масштабируемую инфраструктуру диалогового ИИ для частных лиц, разработчиков и команд. Будь то личный ИИ-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний, AstrBot позволяет быстро создавать ИИ-приложения в рабочем процессе вашей платформы обмена сообщениями.
-
+
## Основные возможности
-1. 💯 Бесплатно & Открытый исходный код.
-2. ✨ Диалоги с ИИ-моделями, мультимодальность, Agent, MCP, Skills, База знаний, Настройка личности, автоматическое сжатие диалогов.
-3. 🤖 Поддержка интеграции с платформами Agents, такими как Dify, Alibaba Cloud Bailian, Coze и др.
-4. 🌐 Мультиплатформенность: поддержка QQ, WeChat для предприятий, Feishu, DingTalk, публичных аккаунтов WeChat, Telegram, Slack и [других](#Поддерживаемые-платформы-обмена-сообщениями).
-5. 📦 Расширение плагинами: доступно более 1000 плагинов для установки в один клик.
-6. 🛡️ Изолированная среда[Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html): безопасное выполнение любого кода, вызов Shell, повторное использование ресурсов на уровне сессии.
+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: встроенная песочница агента, веб-поиск и др.
+8. 🌈 Поддержка Web ChatUI: встроенная песочница агента, веб-поиск и многое другое.
9. 🌐 Поддержка интернационализации (i18n).
-
💙 Ролевые игры & Эмоциональная поддержка
-
✨ Проактивный Агент (Agent)
-
🚀 Универсальные возможности Агента
+
💙 Ролевые игры и Эмоциональное общение
+
✨ Проактивный Агент
+
🚀 Общие агентные возможности
🧩 1000+ плагинов сообщества
@@ -71,162 +71,180 @@ AstrBot — это универсальная платформа Agent-чатб
## Быстрый старт
-### Развёртывание в один клик
+### Развертывание в один клик
-Для пользователей, которые хотят быстро попробовать AstrBot, знакомы с командной строкой и могут самостоятельно установить окружение `uv`, мы рекомендуем использовать развёртывание в один клик через `uv` ⚡️:
+Для пользователей, которые хотят быстро попробовать AstrBot, знакомы с командной строкой и могут самостоятельно установить среду `uv`, мы рекомендуем метод развертывания в один клик с помощью `uv` ⚡️.
```bash
uv tool install astrbot
-astrbot init # Выполните эту команду только при первом запуске для инициализации окружения
+astrbot init # Выполните эту команду только в первый раз для инициализации среды
astrbot run
```
-> Требуется установленный [uv](https://docs.astral.sh/uv/).
+> Требуется установка [uv](https://docs.astral.sh/uv/).
> [!NOTE]
-> Для пользователей macOS: из-за проверок безопасности macOS первый запуск команды `astrbot` может занять больше времени (около 10-20 секунд).
+> Для пользователей macOS: из-за проверки безопасности macOS первый запуск команды `astrbot` может занять длительное время (около 10-20 секунд).
-Обновить `astrbot`:
+Обновление `astrbot`:
```bash
uv tool upgrade astrbot
```
-### Развёртывание Docker
+### Docker развертывание
-Для пользователей, знакомых с контейнерами и которым нужен более стабильный и подходящий для production способ, мы рекомендуем разворачивать AstrBot через Docker / Docker Compose.
+Для пользователей, знакомых с контейнерами и предпочитающих более стабильный метод развертывания, подходящий для продакшн-среды, мы рекомендуем использовать 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).
+Пожалуйста, обратитесь к официальной документации [Развертывание AstrBot с помощью Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
-### Развёртывание на RainYun
+### Развертывание на RainYun
-Для пользователей, которые хотят развернуть AstrBot в один клик и не хотят самостоятельно управлять сервером, мы рекомендуем облачный сервис развёртывания в один клик от RainYun ☁️:
+Для пользователей, которые хотят развернуть AstrBot в один клик и не хотят самостоятельно управлять серверами, мы рекомендуем облачный сервис развертывания RainYun ☁️:
[](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
-### Развёртывание десктопного приложения
+### Клиент для рабочего стола
-Для пользователей, которые хотят использовать AstrBot на десктопе и в основном работают через ChatUI, мы рекомендуем AstrBot App.
+Для пользователей, которые хотят использовать AstrBot на рабочем столе и использовать ChatUI в качестве основного интерфейса, мы рекомендуем AstrBot App.
-Перейдите в [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop), скачайте и установите приложение; этот вариант предназначен для десктопа и не рекомендуется для серверных сценариев.
+Перейдите на [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) для загрузки и установки; этот метод предназначен для использования на десктопе и не рекомендуется для серверных сценариев.
-### Развёртывание через лаунчер
+### Развертывание через Лаунчер
-Также на десктопе, для пользователей, которым нужен быстрый запуск и мультиинстанс с изоляцией окружений, мы рекомендуем AstrBot Launcher.
+Также для настольных ПК, для пользователей, которые хотят быстрого развертывания и изоляции среды для нескольких экземпляров, мы рекомендуем AstrBot Launcher.
-Перейдите в [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher), чтобы скачать и установить.
+Перейдите на [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) для загрузки и установки.
-### Развёртывание на Replit
+### Развертывание на Replit
-Развёртывание через Replit поддерживается сообществом и подходит для онлайн-демо и лёгких тестовых запусков.
+Развертывание на Replit поддерживается сообществом и подходит для онлайн-демонстраций и легких пробных сценариев.
[](https://repl.it/github/AstrBotDevs/AstrBot)
### AUR
-AUR-вариант предназначен для пользователей Arch Linux, которым удобна установка через системный менеджер пакетов.
+Метод AUR предназначен для пользователей Arch Linux, которые хотят установить AstrBot через системный менеджер пакетов.
-Выполните команду ниже для установки `astrbot-git`, затем запустите 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`).
+Если вам нужно панельное управление или более глубокая настройка, обратитесь к [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 к вашим любимым чат-платформам.
+Подключите AstrBot к вашей любимой чат-платформе.
-| Платформа | Поддержка |
+| Платформа | Мейнтейнер |
|---------|---------------|
-| QQ | Официальная |
-| Реализация протокола OneBot v11 | Официальная |
-| Telegram | Официальная |
-| Приложение WeChat Work и интеллектуальный бот WeChat Work | Официальная |
-| Служба поддержки WeChat и официальные аккаунты WeChat | Официальная |
-| Feishu (Lark) | Официальная |
-| 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) | Сообщество |
-
-## Поддерживаемые сервисы моделей
-
-| Сервис | Тип |
+| **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) | Сообщество |
+
+## Поддерживаемые провайдеры моделей
+
+| Провайдер | Тип |
|---------|---------------|
-| 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-шлюз, поддерживает все модели) |
-| [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | Сервисы LLM |
-| [302.AI](https://share.302.ai/rr1M3l) | Сервисы LLM |
-| [TokenPony](https://www.tokenpony.cn/3YPyf) | Сервисы LLM |
-| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | Сервисы LLM |
-| [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE) | Сервисы LLM |
-| ModelScope | Сервисы LLM |
-| OneAPI | Сервисы LLM |
-| Dify | Платформы LLMOps |
-| Приложения Alibaba Cloud Bailian | Платформы LLMOps |
-| Coze | Платформы LLMOps |
-| OpenAI Whisper | Сервисы распознавания речи |
-| SenseVoice | Сервисы распознавания речи |
-| OpenAI TTS | Сервисы синтеза речи |
-| Gemini TTS | Сервисы синтеза речи |
-| GPT-Sovits-Inference | Сервисы синтеза речи |
-| GPT-Sovits | Сервисы синтеза речи |
-| FishAudio | Сервисы синтеза речи |
-| Edge TTS | Сервисы синтеза речи |
-| Alibaba Cloud Bailian TTS | Сервисы синтеза речи |
-| Azure TTS | Сервисы синтеза речи |
-| Minimax TTS | Сервисы синтеза речи |
-| Volcano Engine TTS | Сервисы синтеза речи |
-
-## ❤️ Вклад в проект
-
-Issues и Pull Request всегда приветствуются! Не стесняйтесь отправлять свои изменения в этот проект :)
+| 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 или помогая с ревью pull request. Любые issues или PR приветствуются для поощрения участия сообщества. Конечно, это лишь предложения — вы можете вносить вклад любым удобным для вас способом. Для добавления новых функций сначала обсудите это через Issue.
+Вы можете внести свой вклад, просматривая issues или помогая в проверке PR (Pull Requests). Любая проблема или PR приветствуются для поощрения участия сообщества. Конечно, это всего лишь предложения, и вы можете вносить вклад любым удобным для вас способом. Для добавления новых функций, пожалуйста, сначала обсудите это через Issue.
+Рекомендуется объединять функциональные PR в ветку `dev`, которая будет объединена с основной веткой и выпущена как новая версия после тестирования изменений.
### Среда разработки
-AstrBot использует `ruff` для форматирования и линтинга кода.
+AstrBot использует `ruff` для форматирования и проверки кода.
```bash
git clone https://github.com/AstrBotDevs/AstrBot
-pip install pre-commit
+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
-- Группа разработчиков: 975206796
-- Группа разработчиков (официальная): 1039761811
+- Группа 7: 743746109
+- Группа 8: 1030353265
+- Группа разработчиков (Болталка): 975206796
+- Группа разработчиков (Официальная): 1039761811
-### Сервер Discord
+### Канал Discord
-
+- [Discord](https://discord.gg/hAVk6tgV36)
## ❤️ Особая благодарность
@@ -238,13 +256,22 @@ pre-commit install
Кроме того, рождение этого проекта было бы невозможно без помощи следующих проектов с открытым исходным кодом:
-- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Замечательный кошачий фреймворк
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Великий кошачий фреймворк
-## ⭐ История звёзд
+Дружественные проекты с открытым исходным кодом:
-> [!TIP]
-> Если этот проект помог вам в жизни или работе, или если вас интересует его будущее развитие, пожалуйста, поставьте проекту звезду. Это движущая сила поддержки этого проекта с открытым исходным кодом <3
+- [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
@@ -254,10 +281,10 @@ pre-commit install
-_Сопровождение и способности никогда не должны быть противоположностями. Мы стремимся создать робота, который сможет как понимать эмоции, оказывать душевную поддержку, так и надёжно выполнять работу._
+_Общение и способности никогда не должны быть противоположностями. Мы надеемся создать робота, который сможет понимать эмоции, составлять компанию и надежно выполнять задачи._
_私は、高性能ですから!_
-
+
\ No newline at end of file
diff --git a/README_zh-TW.md b/README_zh-TW.md
index 20749a077f..39fb9de242 100644
--- a/README_zh-TW.md
+++ b/README_zh-TW.md
@@ -2,14 +2,12 @@
-AstrBot is an open-source, one-stop Agentic personal and group chat assistant. It can be deployed on dozens of mainstream instant messaging platforms such as QQ, Telegram, WeCom, Lark (Feishu), DingTalk, Slack, etc. It also features a built-in lightweight ChatUI similar to OpenWebUI, creating a reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether it's a personal AI companion, intelligent customer service, automated assistant, or enterprise knowledge base, AstrBot enables you to quickly build AI applications within the workflow of your instant messaging platforms.
+AstrBot is an open-source, all-in-one Agentic personal and group chat assistant that can be deployed on dozens of mainstream instant messaging platforms such as QQ, Telegram, WeCom, Lark, DingTalk, Slack, and more. It also features a built-in lightweight ChatUI similar to OpenWebUI, creating a reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether it's a personal AI companion, smart customer service, automated assistant, or enterprise knowledge base, AstrBot enables you to quickly build AI applications within the workflow of your instant messaging platforms.

## Key Features
1. 💯 Free & Open Source.
-2. ✨ AI LLM Chat, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona, Auto-summarization.
-3. 🤖 Supports integration with Agent platforms like Dify, Aliyun Bailian, Coze, etc.
-4. 🌐 Multi-platform support: QQ, WeCom, Lark, DingTalk, WeChat Official Account, Telegram, Slack, and [more](#supported-messaging-platforms).
-5. 📦 Plugin Extension: 1000+ plugins available for one-click installation.
-6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html): An isolated environment to safely execute code, call Shell, and reuse session-level resources.
+2. ✨ Large Language Model (LLM) dialogue, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona settings, automatic dialogue compression.
+3. 🤖 Supports integration with agent platforms such as Dify, Alibaba Bailian, Coze, etc.
+4. 🌐 Multi-platform support: QQ, WeCom, Lark, DingTalk, WeChat Official Account, Telegram, Slack, and [more](#supported-message-platforms).
+5. 📦 Plugin extension: 1000+ plugins available for one-click installation.
+6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html): Isolated environment for safely executing any code, calling Shell commands, and reusing session-level resources.
7. 💻 WebUI support.
-8. 🌈 Web ChatUI support: ChatUI features built-in proxy sandbox, web search, etc.
+8. 🌈 Web ChatUI support: Built-in proxy sandbox, web search, etc. within ChatUI.
9. 🌐 Internationalization (i18n) support.
@@ -73,18 +73,21 @@ AstrBot is an open-source, one-stop Agentic personal and group chat assistant. I
### One-Click Deployment
-For users who want to quickly experience AstrBot, are familiar with the command line, and can install the `uv` environment themselves, we recommend using the `uv` one-click deployment method ⚡️.
+For users who want to experience AstrBot quickly, are familiar with the command line, and can install the `uv` environment themselves, we recommend using `uv` for one-click deployment ⚡️.
```bash
uv tool install astrbot
-astrbot init # Run this command only for the first time to initialize the environment
-astrbot run
+astrbot init # Execute this command only for the first time to initialize the environment
+astrbot run # astrbot run --backend-only starts only the backend service
+
+# Install development version (more fixes and new features, but less stable; suitable for developers)
+uv tool install git+https://github.com/AstrBotDevs/AstrBot@dev
```
-> Requires [uv](https://docs.astral.sh/uv/) installation.
+> Requires [uv](https://docs.astral.sh/uv/) installed.
> [!NOTE]
-> For macOS users: Due to macOS security checks, running the `astrbot` command for the first time may take a long time (about 10-20 seconds).
+> For macOS users: Due to macOS security checks, the first execution of the `astrbot` command may take a longer time (about 10-20 seconds).
Update `astrbot`:
@@ -94,7 +97,7 @@ uv tool upgrade astrbot
### Docker Deployment
-For users familiar with containers who prefer a more stable deployment method suitable for production environments, we recommend using Docker / Docker Compose to deploy AstrBot.
+For users familiar with containers who prefer a more stable deployment suitable for production environments, we recommend using Docker / Docker Compose to deploy AstrBot.
Please refer to the official documentation [Deploy AstrBot with Docker](https://astrbot.app/deploy/astrbot/docker.html).
@@ -106,27 +109,27 @@ For users who want to deploy AstrBot with one click and do not want to manage se
### Desktop Client Deployment
-For users who wish to use AstrBot on the desktop and primarily use ChatUI as the entry point, we recommend using the AstrBot App.
+For users who wish to use AstrBot on the desktop with ChatUI as the main interface, we recommend using the AstrBot App.
Go to [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) to download and install; this method is intended for desktop use and is not recommended for server scenarios.
### Launcher Deployment
-Also for desktop use, for users who want to quickly deploy and achieve environment isolation for multiple instances, we recommend AstrBot Launcher.
+Also for desktop, users who want quick deployment and isolated environments for multiple instances can use the AstrBot Launcher.
Go to [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) to download and install.
### Deploy on Replit
-The Replit deployment is maintained by the community and is suitable for online demonstrations and lightweight trial scenarios.
+Replit deployment is maintained by the community, suitable for online demos and lightweight trials.
[](https://repl.it/github/AstrBotDevs/AstrBot)
### AUR
-The AUR method is intended for Arch Linux users who wish to install AstrBot via the system package manager.
+The AUR method is for Arch Linux users who wish to install AstrBot via the system package manager.
-Run the following command in the terminal to install the `astrbot-git` package. Once installed, you can start using it.
+Execute the following command in the terminal to install the `astrbot-git` package. You can start using it after installation completes.
```bash
yay -S astrbot-git
@@ -134,9 +137,9 @@ yay -S astrbot-git
**More Deployment Methods**
-If you need a panel-based or highly customized deployment, please refer to [BT Panel](https://astrbot.app/deploy/astrbot/btpanel.html) (BT Panel App Store installation), [1Panel](https://astrbot.app/deploy/astrbot/1panel.html) (1Panel App Store installation), [CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) (NAS / Home Server visual deployment), and [Manual Deployment](https://astrbot.app/deploy/astrbot/cli.html) (Full custom installation based on source code and `uv`).
+If you need panel-based or highly customized deployment, you can refer to [BT Panel](https://astrbot.app/deploy/astrbot/btpanel.html) (BT Panel App Store), [1Panel](https://astrbot.app/deploy/astrbot/1panel.html) (1Panel App Store), [CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) (NAS / Home Server visual deployment), and [Manual Deployment](https://astrbot.app/deploy/astrbot/cli.html) (Full custom installation based on source code and `uv`).
-## Supported Messaging Platforms
+## Supported Message Platforms
Connect AstrBot to your favorite chat platforms.
@@ -173,7 +176,7 @@ Connect AstrBot to your favorite chat platforms.
| Ollama (Local) | LLM |
| LM Studio (Local) | LLM |
| [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM (API Gateway, supports all models) |
-| [Uyun AI](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM (API Gateway, supports all models) |
+| [Compshare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM (API Gateway, supports all models) |
| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM (API Gateway, supports all models) |
| [PPIO](https://ppio.com/user/register?invited_by=AIOONE) | LLM (API Gateway, supports all models) |
| [302.AI](https://share.302.ai/rr1M3l) | LLM (API Gateway, supports all models)|
@@ -181,7 +184,7 @@ Connect AstrBot to your favorite chat platforms.
| ModelScope | LLM |
| OneAPI | LLM |
| Dify | LLMOps Platform |
-| Aliyun Bailian | LLMOps Platform |
+| Alibaba Bailian | LLMOps Platform |
| Coze | LLMOps Platform |
| OpenAI Whisper | Speech-to-Text |
| SenseVoice | Speech-to-Text |
@@ -191,19 +194,23 @@ Connect AstrBot to your favorite chat platforms.
| GPT-Sovits | Text-to-Speech |
| FishAudio | Text-to-Speech |
| Edge TTS | Text-to-Speech |
-| Aliyun Bailian TTS | Text-to-Speech |
+| Alibaba Bailian TTS | Text-to-Speech |
| Azure TTS | Text-to-Speech |
| Minimax TTS | Text-to-Speech |
-| Volcengine TTS | Text-to-Speech |
+| Volcano Engine TTS | Text-to-Speech |
## ❤️ Contribution
-Issues and Pull Requests are welcome! Just submit your changes to this project :)
+Welcome any Issues/Pull Requests! Just submit your changes to this project :)
### How to Contribute
-You can contribute by viewing issues or helping to review PRs (Pull Requests). Any issue or PR is welcome to participate in promoting community contributions. Of course, these are just suggestions, and you can contribute in any way. For the addition of new features, please discuss via Issue first.
-It is recommended to merge functional PRs into the `dev` branch, which will be merged into the main branch and released as a new version after testing modifications.
+You can contribute by viewing issues or helping to review PRs (Pull Requests). Any issues or PRs are welcome to promote community contribution. Of course, these are just suggestions; you can contribute in any way. For new feature additions, please discuss via Issue first.
+It is recommended to merge functional PRs into the `dev` branch, which will be merged into the main branch and released as a new version after testing.
+To reduce conflicts, we suggest:
+1. Create your working branch based on the `dev` branch, avoid working directly on the `main` branch.
+2. When submitting a PR, select the `dev` branch as the target.
+3. Regularly sync the `dev` branch to your local environment; use `git pull` frequently.
### Development Environment
@@ -215,13 +222,17 @@ git switch dev # Switch to dev branch
pip install pre-commit # or uv tool install pre-commit
pre-commit install
```
-It is recommended to use `uv` for local installation and testing:
+
+We recommend using `uv` for local installation and testing:
+
```bash
uv tool install -e . --force
astrbot init
astrbot run
```
-Frontend debugging:
+
+Frontend Debugging:
+
```bash
astrbot run --backend-only
cd dashboard
@@ -239,7 +250,7 @@ bun dev
- Group 6: 753075035
- Group 7: 743746109
- Group 8: 1030353265
-- Developer Group (Casual Chat): 975206796
+- Developer Group (Casual): 975206796
- Developer Group (Official): 1039761811
### Discord Channel
@@ -248,7 +259,7 @@ bun dev
## ❤️ Special Thanks
-Special thanks to all Contributors and Plugin Developers for their contributions to AstrBot ❤️
+Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
@@ -256,22 +267,22 @@ Special thanks to all Contributors and Plugin Developers for their contributions
In addition, the birth of this project cannot be separated from the help of the following open-source projects:
-- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - The great cat framework
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Great Cat Framework
-Open source project friendly links:
+Open Source Project Friendly Links:
-- [NoneBot2](https://github.com/nonebot/nonebot2) - Excellent Python asynchronous ChatBot framework
-- [Koishi](https://github.com/koishijs/koishi) - Excellent Node.js ChatBot framework
-- [MaiBot](https://github.com/Mai-with-u/MaiBot) - Excellent anthropomorphic AI ChatBot
+- [NoneBot2](https://github.com/nonebot/nonebot2) - Excellent Python Asynchronous ChatBot Framework
+- [Koishi](https://github.com/koishijs/koishi) - Excellent Node.js ChatBot Framework
+- [MaiBot](https://github.com/Mai-with-u/MaiBot) - Excellent Anthropomorphic AI ChatBot
- [nekro-agent](https://github.com/KroMiose/nekro-agent) - Excellent Agent ChatBot
-- [LangBot](https://github.com/langbot-app/LangBot) - Excellent multi-platform AI ChatBot
-- [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Excellent multi-platform AI ChatBot Koishi plugin
-- [Operit AI](https://github.com/AAswordman/Operit) - Excellent AI intelligent assistant Android APP
+- [LangBot](https://github.com/langbot-app/LangBot) - Excellent Multi-platform AI ChatBot
+- [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Excellent Multi-platform AI ChatBot Koishi Plugin
+- [Operit AI](https://github.com/AAswordman/Operit) - Excellent AI Assistant Android APP
## ⭐ Star History
> [!TIP]
-> If this project has been helpful to your life/work, or if you are interested in the future development of this project, please give the project a Star. This is our motivation to maintain this open-source project <3
+> If this project helps your life/work, or you are concerned about the future development of this project, please Star the project. This is our motivation to maintain this open-source project <3
-
- AstrBot est un assistant de discussion personnel et de groupe Agentic open-source tout-en-un, déployable sur des dizaines de logiciels de messagerie instantanée grand public tels que QQ, Telegram, WeCom (Entreprise WeChat), Lark (Feishu), DingTalk, Slack, etc. Il intègre également une interface de chat légère (ChatUI) similaire à OpenWebUI, créant une infrastructure d'IA conversationnelle fiable et évolutive pour les particuliers, les développeurs et les équipes. Qu'il s'agisse d'un compagnon IA personnel, d'un service client intelligent, d'un assistant d'automatisation ou d'une base de connaissances d'entreprise, AstrBot vous permet de construire rapidement des applications IA au sein du flux de travail de votre plateforme de messagerie instantanée.
-
- 
-
- ## Principales Fonctionnalités
+
+
+
+
+
- 1. 💯 Gratuit & Open Source.
- 2. ✨ Conversation IA LLM, Multimodal, Agent, MCP, Skills, Base de connaissances, Personnalité, Compression automatique du dialogue.
- 3. 🤖 Prise en charge de l'intégration avec des plateformes d'agents telles que Dify, Aliyun Bailian, Coze, etc.
- 4. 🌐 Multi-plateforme, prend en charge QQ, WeCom, Lark, DingTalk, Comptes Officiels WeChat, Telegram, Slack et [plus](#plateformes-de-messagerie-prises-en-charge).
- 5. 📦 Extension de plugins, plus de 1000 plugins disponibles pour une installation en un clic.
- 6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) Environnement isolé pour exécuter du code en toute sécurité, appeler le Shell et réutiliser les ressources au niveau de la session.
- 7. 💻 Support WebUI.
- 8. 🌈 Support Web ChatUI, ChatUI intègre un bac à sable d'agent, une recherche Web, etc.
- 9. 🌐 Support de l'internationalisation (i18n).
+
-
+Accueil |
+Documentation |
+Blog |
+Feuille de route |
+Signaler un problème
+Email
-
-
-
💙 Jeu de rôle & Compagnonnage
-
✨ Agent Proactif
-
🚀 Capacités Agentic Générales
-
🧩 1000+ Plugins Communautaires
-
-
-
-
-
-
-
-
+
- ## Démarrage Rapide
+AstrBot est un assistant de chat personnel et de groupe Agentic tout-en-un et open-source, qui peut être déployé sur des dizaines de logiciels de messagerie instantanée grand public tels que QQ, Telegram, WeCom (WeChat Entreprise), Lark (Feishu), DingTalk, Slack, etc. Il intègre également une interface de chat légère similaire à OpenWebUI, créant ainsi une infrastructure conversationnelle intelligente fiable et extensible pour les particuliers, les développeurs et les équipes. Qu'il s'agisse d'un compagnon IA personnel, d'un service client intelligent, d'un assistant automatisé ou d'une base de connaissances d'entreprise, AstrBot vous permet de construire rapidement des applications IA au sein du flux de travail de vos plateformes de messagerie instantanée.
- ### Déploiement en un clic
+
- Pour les utilisateurs qui souhaitent expérimenter rapidement AstrBot, qui sont familiers avec la ligne de commande et capables d'installer l'environnement `uv` par eux-mêmes, nous recommandons la méthode de déploiement en un clic `uv` ⚡️.
+## Fonctionnalités Principales
- ```bash
- uv tool install astrbot
- astrbot init # Exécutez cette commande uniquement la première fois pour initialiser l'environnement
- astrbot run
- ```
+1. 💯 Gratuit & Open Source.
+2. ✨ Dialogue avec de grands modèles d'IA (LLM), multimodal, Agent, MCP, Compétences (Skills), base de connaissances, définition de persona, compression automatique des dialogues.
+3. 🤖 Prend en charge l'intégration avec des plateformes d'agents comme Dify, Alibaba Bailian, Coze, etc.
+4. 🌐 Multiplateforme, prend en charge QQ, WeCom, Lark, DingTalk, Compte Officiel WeChat, Telegram, Slack et [plus encore](#plateformes-de-messagerie-prises-en-charge).
+5. 📦 Extension par plugins, plus de 1000 plugins disponibles pour une installation en un clic.
+6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) : environnement isolé pour exécuter n'importe quel code, appeler le Shell et réutiliser les ressources au niveau de la session en toute sécurité.
+7. 💻 Support WebUI.
+8. 🌈 Support Web ChatUI, avec sandbox de proxy intégré, recherche web, etc.
+9. 🌐 Support de l'internationalisation (i18n).
- > Nécessite l'installation de [uv](https://docs.astral.sh/uv/).
+
- > [!NOTE]
- > Pour les utilisateurs de macOS : en raison des vérifications de sécurité de macOS, la première exécution de la commande `astrbot` peut prendre un certain temps (environ 10-20 secondes).
+
+
+
💙 Jeu de rôle & Accompagnement émotionnel
+
✨ Agent Proactif
+
🚀 Capacités Agentic Génériques
+
🧩 1000+ Plugins Communautaires
+
+
+
+
+
+
+
+
- Mettre à jour `astrbot` :
+## Démarrage Rapide
- ```bash
- uv tool upgrade astrbot
- ```
+### Déploiement en un clic
- ### Déploiement Docker
+Pour les utilisateurs qui souhaitent essayer AstrBot rapidement, qui sont familiers avec la ligne de commande et capables d'installer l'environnement `uv` par eux-mêmes, nous recommandons la méthode de déploiement en un clic avec `uv` ⚡️.
- Pour les utilisateurs familiers avec les conteneurs et souhaitant une méthode de déploiement plus stable et adaptée aux environnements de production, nous recommandons d'utiliser Docker / Docker Compose pour déployer AstrBot.
+```bash
+uv tool install astrbot
+astrbot init # Exécutez cette commande uniquement la première fois pour initialiser l'environnement
+astrbot run # astrbot run --backend-only démarre uniquement le service backend
- Veuillez vous référer à la documentation officielle [Déployer AstrBot avec Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+# Installer la version de développement (plus de correctifs, nouvelles fonctionnalités, mais moins stable, adapté aux développeurs)
+uv tool install git+https://github.com/AstrBotDevs/AstrBot@dev
+```
- ### Déploiement sur RainYun
+> Nécessite l'installation de [uv](https://docs.astral.sh/uv/).
- Pour les utilisateurs qui souhaitent déployer AstrBot en un clic et ne veulent pas gérer de serveurs eux-mêmes, nous recommandons le service de déploiement cloud en un clic de RainYun ☁️ :
+> [!NOTE]
+> Pour les utilisateurs de macOS : en raison des contrôles de sécurité de macOS, la première exécution de la commande `astrbot` peut prendre un certain temps (environ 10-20 secondes).
- [](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
+Mettre à jour `astrbot` :
- ### Déploiement Client de Bureau
+```bash
+uv tool upgrade astrbot
+```
- Pour les utilisateurs souhaitant utiliser AstrBot sur ordinateur et utilisant principalement ChatUI comme point d'entrée, nous recommandons AstrBot App.
+### Déploiement Docker
- Allez sur [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) pour télécharger et installer ; cette méthode est destinée à un usage sur ordinateur de bureau et n'est pas recommandée pour les scénarios serveur.
+Pour les utilisateurs familiers avec les conteneurs et souhaitant une méthode de déploiement plus stable et adaptée aux environnements de production, nous recommandons d'utiliser Docker / Docker Compose pour déployer AstrBot.
- ### Déploiement via Lanceur
+Veuillez vous référer à la documentation officielle [Déployer AstrBot avec Docker](https://astrbot.app/deploy/astrbot/docker.html).
- Toujours sur ordinateur, pour les utilisateurs souhaitant déployer rapidement et isoler l'environnement pour plusieurs instances, nous recommandons AstrBot Launcher.
+### Déploiement sur RainYun
- Allez sur [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) pour télécharger et installer.
+Pour les utilisateurs souhaitant déployer AstrBot en un clic sans gérer de serveur, nous recommandons le service de déploiement cloud en un clic de RainYun ☁️ :
- ### Déploiement sur Replit
+[](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
- Le déploiement Replit est maintenu par la communauté et convient aux démonstrations en ligne et aux essais légers.
+### Déploiement Client Bureau
- [](https://repl.it/github/AstrBotDevs/AstrBot)
+Pour les utilisateurs souhaitant utiliser AstrBot sur ordinateur de bureau et utiliser principalement ChatUI comme point d'entrée, nous recommandons l'application AstrBot App.
- ### AUR
+Rendez-vous sur [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) pour télécharger et installer ; cette méthode est destinée à un usage bureautique et n'est pas recommandée pour les scénarios serveur.
- La méthode AUR est destinée aux utilisateurs d'Arch Linux qui souhaitent installer AstrBot via le gestionnaire de paquets du système.
-
- Exécutez la commande ci-dessous dans le terminal pour installer le paquet `astrbot-git`, une fois l'installation terminée, vous pouvez le lancer.
-
- ```bash
- yay -S astrbot-git
- ```
+### Déploiement Launcher
- **Plus de méthodes de déploiement**
+Également pour une utilisation sur bureau, pour les utilisateurs souhaitant un déploiement rapide et une isolation de l'environnement pour plusieurs instances, nous recommandons AstrBot Launcher.
- Si vous avez besoin d'une gestion par panneau ou d'un déploiement plus personnalisé, veuillez consulter [BT Panel](https://astrbot.app/deploy/astrbot/btpanel.html) (Installation via le magasin d'applications BT Panel), [1Panel](https://astrbot.app/deploy/astrbot/1panel.html) (Installation via le magasin d'applications 1Panel), [CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) (Déploiement visuel NAS / Serveur domestique) et [Déploiement Manuel](https://astrbot.app/deploy/astrbot/cli.html) (Installation entièrement personnalisée basée sur le code source et `uv`).
-
- ## Plateformes de messagerie prises en charge
-
- Connectez AstrBot à votre plateforme de chat préférée.
-
- | Plateforme | Mainteneur |
- |---------|---------------|
- | **QQ** | Officiel |
- | **OneBot v11** | Officiel |
- | **Telegram** | Officiel |
- | **App WeCom & Bot Intelligent** | Officiel |
- | **Service Client WeChat & Compte Officiel** | Officiel |
- | **Feishu (Lark)** | Officiel |
- | **DingTalk** | Officiel |
- | **Slack** | Officiel |
- | **Discord** | Officiel |
- | **LINE** | Officiel |
- | **Satori** | Officiel |
- | **Misskey** | Officiel |
- | **Whatsapp (Bientôt disponible)** | Officiel |
- | [**Matrix**](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Communauté |
- | [**KOOK**](https://github.com/wuyan1003/astrbot_plugin_kook_adapter) | Communauté |
- | [**VoceChat**](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Communauté |
+Rendez-vous sur [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) pour télécharger et installer.
- ## Fournisseurs de modèles pris en charge
+### Déploiement sur Replit
- | Fournisseur | Type |
- |---------|---------------|
- | Personnalisé | Tout service compatible OpenAI API |
- | OpenAI | LLM |
- | Anthropic | LLM |
- | Google Gemini | LLM |
- | Moonshot AI | LLM |
- | Zhipu AI | LLM |
- | DeepSeek | LLM |
- | Ollama (Local) | LLM |
- | LM Studio (Local) | LLM |
- | [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM (Passerelle API, supporte tous les modèles) |
- | [Uyun AI](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM (Passerelle API, supporte tous les modèles) |
- | [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM (Passerelle API, supporte tous les modèles) |
- | [PPIO](https://ppio.com/user/register?invited_by=AIOONE) | LLM (Passerelle API, supporte tous les modèles) |
- | [302.AI](https://share.302.ai/rr1M3l) | LLM (Passerelle API, supporte tous les modèles)|
- | [TokenPony](https://www.tokenpony.cn/3YPyf) | LLM (Passerelle API, supporte tous les modèles)|
- | ModelScope | LLM |
- | OneAPI | LLM |
- | Dify | Plateforme LLMOps |
- | Aliyun Bailian | Plateforme LLMOps |
- | Coze | Plateforme LLMOps |
- | OpenAI Whisper | Synthèse vocale (STT) |
- | SenseVoice | Synthèse vocale (STT) |
- | OpenAI TTS | Synthèse vocale (TTS) |
- | Gemini TTS | Synthèse vocale (TTS) |
- | GPT-Sovits-Inference | Synthèse vocale (TTS) |
- | GPT-Sovits | Synthèse vocale (TTS) |
- | FishAudio | Synthèse vocale (TTS) |
- | Edge TTS | Synthèse vocale (TTS) |
- | Aliyun Bailian TTS | Synthèse vocale (TTS) |
- | Azure TTS | Synthèse vocale (TTS) |
- | Minimax TTS | Synthèse vocale (TTS) |
- | Volcengine TTS | Synthèse vocale (TTS) |
+Le déploiement sur Replit est maintenu par la communauté et convient aux démonstrations en ligne et aux scénarios d'essai légers.
- ## ❤️ Contribution
+[](https://repl.it/github/AstrBotDevs/AstrBot)
- Les Issues et Pull Requests sont les bienvenus ! Soumettez simplement vos modifications à ce projet :)
+### AUR
- ### Comment contribuer
+La méthode AUR est destinée aux utilisateurs d'Arch Linux souhaitant installer AstrBot via le gestionnaire de paquets du système.
+
+Exécutez la commande ci-dessous dans le terminal pour installer le paquet `astrbot-git`. Une fois l'installation terminée, vous pouvez le lancer.
+
+```bash
+yay -S astrbot-git
+```
+
+**Plus de méthodes de déploiement**
+
+Si vous avez besoin d'un déploiement via panneau de contrôle ou hautement personnalisé, vous pouvez consulter [BT Panel](https://astrbot.app/deploy/astrbot/btpanel.html) (installation via le magasin d'applications BT Panel), [1Panel](https://astrbot.app/deploy/astrbot/1panel.html) (installation via le magasin d'applications 1Panel), [CasaOS](https://astrbot.app/deploy/astrbot/casaos.html) (déploiement visuel pour NAS / serveur domestique) et [Déploiement Manuel](https://astrbot.app/deploy/astrbot/cli.html) (installation personnalisée complète basée sur le code source et `uv`).
+
+## Plateformes de Messagerie Prises en Charge
+
+Connectez AstrBot à vos plateformes de chat préférées.
+
+| Plateforme | Mainteneur |
+|---------|---------------|
+| **QQ** | Officiel |
+| **OneBot v11** | Officiel |
+| **Telegram** | Officiel |
+| **WeCom (App & Smart Bot)** | Officiel |
+| **WeChat (Service Client & Compte Officiel)** | Officiel |
+| **Lark (Feishu)** | Officiel |
+| **DingTalk** | Officiel |
+| **Slack** | Officiel |
+| **Discord** | Officiel |
+| **LINE** | Officiel |
+| **Satori** | Officiel |
+| **Misskey** | Officiel |
+| **Whatsapp (Bientôt)** | Officiel |
+| [**Matrix**](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Communauté |
+| [**KOOK**](https://github.com/wuyan1003/astrbot_plugin_kook_adapter) | Communauté |
+| [**VoceChat**](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Communauté |
- Vous pouvez contribuer en examinant les problèmes ou en aidant à examiner les PR (Pull Requests). Tout problème ou PR est le bienvenu pour encourager la participation de la communauté. Bien sûr, ce ne sont que des suggestions, vous pouvez contribuer de n'importe quelle manière. Pour l'ajout de nouvelles fonctionnalités, veuillez d'abord en discuter via une Issue.
- Il est recommandé de fusionner les PR fonctionnels dans la branche `dev`, qui sera fusionnée dans la branche principale et publiée en tant que nouvelle version après les tests de modification.
+## Fournisseurs de Modèles Pris en Charge
- ### Environnement de développement
+| Fournisseur | Type |
+|---------|---------------|
+| Personnalisé | Tout service compatible avec l'API OpenAI |
+| OpenAI | LLM |
+| Anthropic | LLM |
+| Google Gemini | LLM |
+| Moonshot AI | LLM |
+| Zhipu AI | LLM |
+| DeepSeek | LLM |
+| Ollama (Local) | LLM |
+| LM Studio (Local) | LLM |
+| [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM (Passerelle API, supporte tous les modèles) |
+| [Uyun AI](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM (Passerelle API, supporte tous les modèles) |
+| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM (Passerelle API, supporte tous les modèles) |
+| [PPIO](https://ppio.com/user/register?invited_by=AIOONE) | LLM (Passerelle API, supporte tous les modèles) |
+| [302.AI](https://share.302.ai/rr1M3l) | LLM (Passerelle API, supporte tous les modèles)|
+| [TokenPony](https://www.tokenpony.cn/3YPyf) | LLM (Passerelle API, supporte tous les modèles)|
+| ModelScope | LLM |
+| OneAPI | LLM |
+| Dify | Plateforme LLMOps |
+| Alibaba Bailian | Plateforme LLMOps |
+| Coze | Plateforme LLMOps |
+| OpenAI Whisper | Synthèse vocale (Speech-to-Text) |
+| SenseVoice | Synthèse vocale (Speech-to-Text) |
+| OpenAI TTS | Synthèse vocale (Text-to-Speech) |
+| Gemini TTS | Synthèse vocale (Text-to-Speech) |
+| GPT-Sovits-Inference | Synthèse vocale (Text-to-Speech) |
+| GPT-Sovits | Synthèse vocale (Text-to-Speech) |
+| FishAudio | Synthèse vocale (Text-to-Speech) |
+| Edge TTS | Synthèse vocale (Text-to-Speech) |
+| Alibaba Bailian TTS | Synthèse vocale (Text-to-Speech) |
+| Azure TTS | Synthèse vocale (Text-to-Speech) |
+| Minimax TTS | Synthèse vocale (Text-to-Speech) |
+| Volcengine TTS | Synthèse vocale (Text-to-Speech) |
- AstrBot utilise `ruff` pour le formatage et la vérification du code.
+## ❤️ Contribution
+
+Les Issues et Pull Requests sont les bienvenus ! Soumettez simplement vos modifications à ce projet :)
+
+### Comment Contribuer
+
+Vous pouvez contribuer en examinant les problèmes ou en aidant à réviser les PR (Pull Requests). Tout problème ou PR est le bienvenu pour promouvoir la contribution communautaire. Bien sûr, ce ne sont que des suggestions, vous pouvez contribuer de n'importe quelle manière. Pour l'ajout de nouvelles fonctionnalités, veuillez d'abord en discuter via une Issue.
+Il est recommandé de fusionner les PR fonctionnels dans la branche `dev`, qui sera fusionnée dans la branche principale et publiée en tant que nouvelle version après test des modifications.
+Pour réduire les conflits, nous suggérons :
+1. Créez votre branche de travail basée sur la branche `dev`, évitez de travailler directement sur la branche `main`.
+2. Lors de la soumission d'une PR, sélectionnez la branche `dev` comme cible.
+3. Synchronisez régulièrement la branche `dev` en local, utilisez souvent `git pull`.
+
+### Environnement de Développement
+
+AstrBot utilise `ruff` pour le formatage et la vérification du code.
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot
+git switch dev # Basculer vers la branche de développement
+pip install pre-commit # ou uv tool install pre-commit
+pre-commit install
+```
+Il est recommandé d'utiliser `uv` pour l'installation locale et les tests.
+```bash
+uv tool install -e . --force
+astrbot init
+astrbot run
+```
+Débogage frontend
+```bash
+astrbot run --backend-only
+cd dashboard
+bun install # ou pnpm, etc.
+bun dev
+```
+
+### Groupes QQ
+
+- Groupe 9 : 1076659624 (Nouveau)
+- Groupe 10 : 1078079676 (Nouveau)
+- Groupe 1 : 322154837
+- Groupe 3 : 630166526
+- Groupe 5 : 822130018
+- Groupe 6 : 753075035
+- Groupe 7 : 743746109
+- Groupe 8 : 1030353265
+- Groupe Développeurs (Discussion libre) : 975206796
+- Groupe Développeurs (Officiel) : 1039761811
+
+### Canal Discord
+
+- [Discord](https://discord.gg/hAVk6tgV36)
+
+## ❤️ Remerciements Spéciaux
+
+Un grand merci à tous les Contributeurs et développeurs de plugins pour leur contribution à AstrBot ❤️
+
+
+
+
+
+De plus, la naissance de ce projet n'aurait pas été possible sans l'aide des projets open source suivants :
+
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Le grand framework félin
+
+Liens amicaux vers des projets open source :
+
+- [NoneBot2](https://github.com/nonebot/nonebot2) - Excellent framework de ChatBot asynchrone en Python
+- [Koishi](https://github.com/koishijs/koishi) - Excellent framework de ChatBot en Node.js
+- [MaiBot](https://github.com/Mai-with-u/MaiBot) - Excellent ChatBot IA anthropomorphe
+- [nekro-agent](https://github.com/KroMiose/nekro-agent) - Excellent ChatBot Agent
+- [LangBot](https://github.com/langbot-app/LangBot) - Excellent ChatBot IA multiplateforme
+- [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Excellent plugin Koishi de ChatBot IA multiplateforme
+- [Operit AI](https://github.com/AAswordman/Operit) - Excellente application Android d'assistant intelligent IA
+
+## ⭐ Historique des Étoiles
+
+> [!TIP]
+> Si ce projet vous a été utile dans votre vie ou votre travail, ou si vous vous intéressez à son développement futur, merci de lui donner une Étoile. C'est notre motivation pour maintenir ce projet open source <3
- ```bash
- git clone https://github.com/AstrBotDevs/AstrBot
- git switch dev # Basculer vers la branche de développement
- pip install pre-commit # ou uv tool install pre-commit
- pre-commit install
- ```
- Il est recommandé d'utiliser uv pour l'installation locale et les tests
- ```bash
- uv tool install -e . --force
- astrbot init
- astrbot run
- ```
- Débogage frontend
- ```bash
- astrbot run --backend-only
- cd dashboard
- bun install # ou pnpm, etc.
- bun dev
- ```
-
- ### Groupes QQ
-
- - Groupe 9 : 1076659624 (Nouveau)
- - Groupe 10 : 1078079676 (Nouveau)
- - Groupe 1 : 322154837
- - Groupe 3 : 630166526
- - Groupe 5 : 822130018
- - Groupe 6 : 753075035
- - Groupe 7 : 743746109
- - Groupe 8 : 1030353265
- - Groupe de développeurs (Discussion informelle) : 975206796
- - Groupe de développeurs (Officiel) : 1039761811
-
- ### Canal Discord
-
- - [Discord](https://discord.gg/hAVk6tgV36)
-
- ## ❤️ Remerciements Spéciaux
-
- Merci tout particulièrement à tous les Contributeurs et développeurs de plugins pour leurs contributions à AstrBot ❤️
-
-
-
-
-
- De plus, la naissance de ce projet n'aurait pas été possible sans l'aide des projets open-source suivants :
-
- - [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Le formidable framework chat
-
- Liens amicaux vers des projets open source :
-
- - [NoneBot2](https://github.com/nonebot/nonebot2) - Excellent framework de ChatBot asynchrone Python
- - [Koishi](https://github.com/koishijs/koishi) - Excellent framework de ChatBot Node.js
- - [MaiBot](https://github.com/Mai-with-u/MaiBot) - Excellent ChatBot IA anthropomorphique
- - [nekro-agent](https://github.com/KroMiose/nekro-agent) - Excellent ChatBot Agent
- - [LangBot](https://github.com/langbot-app/LangBot) - Excellent ChatBot IA multi-plateforme
- - [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Excellent plugin ChatBot IA multi-plateforme pour Koishi
- - [Operit AI](https://github.com/AAswordman/Operit) - Excellente application Android d'assistant intelligent IA
-
- ## ⭐ Star History
-
- > [!TIP]
- > Si ce projet vous a aidé dans votre vie / travail, ou si vous êtes intéressé par le développement futur de ce projet, veuillez donner une étoile (Star) au projet, c'est notre motivation pour maintenir ce projet open-source <3
-
-
+
- [](https://star-history.com/#astrbotdevs/astrbot&Date)
+[](https://star-history.com/#astrbotdevs/astrbot&Date)
-
+
-
+
- _La compagnie et la capacité ne devraient jamais être opposées. Nous espérons créer un robot capable à la fois de comprendre les émotions, d'offrir de la compagnie, et d'accomplir des tâches de manière fiable._
+_La compagnie et la compétence ne devraient jamais être opposées. Nous espérons créer un robot capable à la fois de comprendre les émotions, d'offrir de la compagnie et d'accomplir des tâches de manière fiable._
- _私は、高性能ですから!_
+_私は、高性能ですから!_ (Je suis performant !)
-
+
-
-AstrBot — это универсальный агентный помощник для личных и групповых чатов с открытым исходным кодом. Он может быть развернут в десятках популярных мессенджеров, таких как QQ, Telegram, WeCom, Lark (Feishu), DingTalk, Slack и других. Кроме того, он имеет встроенный легковесный веб-интерфейс ChatUI, похожий на OpenWebUI, что создает надежную и масштабируемую инфраструктуру диалогового ИИ для частных лиц, разработчиков и команд. Будь то личный ИИ-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний, AstrBot позволяет быстро создавать ИИ-приложения в рабочем процессе вашей платформы обмена сообщениями.
+AstrBot — это универсальный агентский помощник для личных и групповых чатов с открытым исходным кодом. Он может быть развернут в десятках популярных мессенджеров, таких как QQ, Telegram, WeCom (Enterprise WeChat), Lark (Feishu), DingTalk, Slack и других. Кроме того, он имеет встроенный легковесный веб-интерфейс чата (ChatUI), похожий на OpenWebUI, создавая надежную и масштабируемую диалоговую интеллектуальную инфраструктуру для частных лиц, разработчиков и команд. Будь то личный AI-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний, AstrBot позволяет быстро создавать AI-приложения в рабочем процессе ваших платформ обмена мгновенными сообщениями.

## Основные возможности
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 и повторного использования ресурсов на уровне сессии.
+2. ✨ Поддержка диалога с большими языковыми моделями (LLM), мультимодальность, Агенты, MCP, Навыки (Skills), База знаний, Персонализация, автоматическое сжатие диалога.
+3. 🤖 Поддержка интеграции с платформами агентов, такими как Dify, Alibaba Bailian, Coze и др.
+4. 🌐 Мультиплатформенность: поддержка QQ, WeCom, Lark, DingTalk, WeChat Official Account, Telegram, Slack и [других](#поддерживаемые-платформы-сообщений).
+5. 📦 Расширение плагинами: доступно более 1000 плагинов для установки в один клик.
+6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html): Изолированная среда для безопасного выполнения любого кода, вызова Shell и повторного использования ресурсов на уровне сессии.
7. 💻 Поддержка WebUI.
-8. 🌈 Поддержка Web ChatUI: встроенная песочница агента, веб-поиск и многое другое.
+8. 🌈 Поддержка Web ChatUI: встроенная прокси-песочница, веб-поиск и многое другое внутри ChatUI.
9. 🌐 Поддержка интернационализации (i18n).
@@ -58,8 +58,8 @@ AstrBot — это универсальный агентный помощник
💙 Ролевые игры и Эмоциональное общение
✨ Проактивный Агент
-
🚀 Общие агентные возможности
-
🧩 1000+ плагинов сообщества
+
🚀 Общие агентские возможности
+
🧩 1000+ Плагинов сообщества
@@ -73,18 +73,21 @@ AstrBot — это универсальный агентный помощник
### Развертывание в один клик
-Для пользователей, которые хотят быстро попробовать AstrBot, знакомы с командной строкой и могут самостоятельно установить среду `uv`, мы рекомендуем метод развертывания в один клик с помощью `uv` ⚡️.
+Для пользователей, которые хотят быстро протестировать AstrBot, знакомы с командной строкой и могут самостоятельно установить среду `uv`, мы рекомендуем метод развертывания в один клик с помощью `uv` ⚡️.
```bash
uv tool install astrbot
astrbot init # Выполните эту команду только в первый раз для инициализации среды
-astrbot run
+astrbot run # astrbot run --backend-only запускает только бэкенд сервис
+
+# Установка версии для разработчиков (больше исправлений и новых функций, но менее стабильна; подходит для разработчиков)
+uv tool install git+https://github.com/AstrBotDevs/AstrBot@dev
```
-> Требуется установка [uv](https://docs.astral.sh/uv/).
+> Требуется установленный [uv](https://docs.astral.sh/uv/).
> [!NOTE]
-> Для пользователей macOS: из-за проверки безопасности macOS первый запуск команды `astrbot` может занять длительное время (около 10-20 секунд).
+> Для пользователей macOS: Из-за проверок безопасности macOS первый запуск команды `astrbot` может занять длительное время (около 10-20 секунд).
Обновление `astrbot`:
@@ -92,41 +95,41 @@ astrbot run
uv tool upgrade astrbot
```
-### Docker развертывание
+### Развертывание через Docker
-Для пользователей, знакомых с контейнерами и предпочитающих более стабильный метод развертывания, подходящий для продакшн-среды, мы рекомендуем использовать Docker / Docker Compose.
+Для пользователей, знакомых с контейнерами и предпочитающих более стабильный метод развертывания, подходящий для производственных сред, мы рекомендуем использовать Docker / Docker Compose для развертывания AstrBot.
-Пожалуйста, обратитесь к официальной документации [Развертывание AstrBot с помощью Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+Пожалуйста, обратитесь к официальной документации [Развертывание AstrBot с помощью Docker](https://astrbot.app/deploy/astrbot/docker.html).
### Развертывание на RainYun
-Для пользователей, которые хотят развернуть AstrBot в один клик и не хотят самостоятельно управлять серверами, мы рекомендуем облачный сервис развертывания RainYun ☁️:
+Для пользователей, которые хотят развернуть AstrBot в один клик и не хотят самостоятельно управлять серверами, мы рекомендуем облачный сервис развертывания в один клик от RainYun ☁️:
[](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
-### Клиент для рабочего стола
+### Развертывание настольного клиента
-Для пользователей, которые хотят использовать AstrBot на рабочем столе и использовать ChatUI в качестве основного интерфейса, мы рекомендуем AstrBot App.
+Для пользователей, желающих использовать AstrBot на рабочем столе и использовать ChatUI в качестве основного интерфейса, мы рекомендуем приложение AstrBot App.
-Перейдите на [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) для загрузки и установки; этот метод предназначен для использования на десктопе и не рекомендуется для серверных сценариев.
+Перейдите на [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) для загрузки и установки; этот метод предназначен для использования на рабочем столе и не рекомендуется для серверных сценариев.
-### Развертывание через Лаунчер
+### Развертывание через лаунчер
-Также для настольных ПК, для пользователей, которые хотят быстрого развертывания и изоляции среды для нескольких экземпляров, мы рекомендуем AstrBot Launcher.
+Также для настольных компьютеров, для пользователей, которым требуется быстрое развертывание и изоляция среды для нескольких экземпляров, мы рекомендуем AstrBot Launcher.
Перейдите на [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) для загрузки и установки.
### Развертывание на Replit
-Развертывание на Replit поддерживается сообществом и подходит для онлайн-демонстраций и легких пробных сценариев.
+Развертывание на Replit поддерживается сообществом и подходит для онлайн-демонстраций и легких тестовых сценариев.
[](https://repl.it/github/AstrBotDevs/AstrBot)
### AUR
-Метод AUR предназначен для пользователей Arch Linux, которые хотят установить AstrBot через системный менеджер пакетов.
+Метод AUR предназначен для пользователей Arch Linux, желающих установить AstrBot через системный менеджер пакетов.
-Выполните следующую команду в терминале, чтобы установить пакет `astrbot-git`. После установки вы можете запустить его.
+Выполните приведенную ниже команду в терминале, чтобы установить пакет `astrbot-git`. После завершения установки вы сможете запустить его.
```bash
yay -S astrbot-git
@@ -134,27 +137,27 @@ 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`).
+Если вам требуется панельное управление или более кастомизированное развертывание, вы можете обратиться к [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 к вашей любимой чат-платформе.
+Подключите AstrBot к вашим любимым платформам чата.
-| Платформа | Мейнтейнер |
+| Платформа | Поддержка |
|---------|---------------|
-| **QQ** | Официальный |
-| **OneBot v11** | Официальный |
-| **Telegram** | Официальный |
-| **Приложение WeCom и бот** | Официальный |
-| **WeChat Customer Service & Official Account** | Официальный |
-| **Lark (Feishu)** | Официальный |
-| **DingTalk** | Официальный |
-| **Slack** | Официальный |
-| **Discord** | Официальный |
-| **LINE** | Официальный |
-| **Satori** | Официальный |
-| **Misskey** | Официальный |
-| **Whatsapp (Скоро)** | Официальный |
+| **QQ** | Официальная |
+| **OneBot v11** | Официальная |
+| **Telegram** | Официальная |
+| **WeCom (Приложение & Смарт-бот)** | Официальная |
+| **WeChat (Служба поддержки & Официальный аккаунт)** | Официальная |
+| **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) | Сообщество |
@@ -163,7 +166,7 @@ yay -S astrbot-git
| Провайдер | Тип |
|---------|---------------|
-| Custom | Любой сервис, совместимый с OpenAI API |
+| Пользовательский | Любой сервис, совместимый с OpenAI API |
| OpenAI | LLM |
| Anthropic | LLM |
| Google Gemini | LLM |
@@ -172,17 +175,17 @@ yay -S astrbot-git
| 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 шлюз, поддержка всех моделей)|
+| [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 платформа |
+| Dify | Платформа LLMOps |
+| Alibaba Bailian | Платформа LLMOps |
+| Coze | Платформа LLMOps |
| OpenAI Whisper | Распознавание речи (STT) |
| SenseVoice | Распознавание речи (STT) |
| OpenAI TTS | Синтез речи (TTS) |
@@ -191,19 +194,23 @@ yay -S astrbot-git
| GPT-Sovits | Синтез речи (TTS) |
| FishAudio | Синтез речи (TTS) |
| Edge TTS | Синтез речи (TTS) |
-| Aliyun Bailian TTS | Синтез речи (TTS) |
+| Alibaba Bailian TTS | Синтез речи (TTS) |
| Azure TTS | Синтез речи (TTS) |
| Minimax TTS | Синтез речи (TTS) |
| Volcengine TTS | Синтез речи (TTS) |
-## ❤️ Вклад
+## ❤️ Вклад в проект
-Приветствуются любые Issues и Pull Requests! Просто отправьте ваши изменения в этот проект :)
+Мы приветствуем любые Issues и Pull Requests! Просто отправьте свои изменения в этот проект :)
### Как внести вклад
-Вы можете внести свой вклад, просматривая issues или помогая в проверке PR (Pull Requests). Любая проблема или PR приветствуются для поощрения участия сообщества. Конечно, это всего лишь предложения, и вы можете вносить вклад любым удобным для вас способом. Для добавления новых функций, пожалуйста, сначала обсудите это через Issue.
-Рекомендуется объединять функциональные PR в ветку `dev`, которая будет объединена с основной веткой и выпущена как новая версия после тестирования изменений.
+Вы можете внести свой вклад, просматривая проблемы (Issues) или помогая проверять PR (Pull Requests). Любая проблема или PR приветствуются для поощрения участия сообщества. Конечно, это всего лишь предложения, вы можете внести свой вклад любым способом. Для добавления новых функций, пожалуйста, сначала обсудите это через Issue.
+Рекомендуется объединять функциональные PR в ветку `dev`, которая будет объединена с основной веткой (`main`) и выпущена как новая версия после тестирования изменений.
+Для уменьшения конфликтов мы рекомендуем:
+1. Создавайте рабочую ветку на основе ветки `dev`, избегайте работы напрямую в ветке `main`.
+2. При отправке PR выбирайте ветку `dev` в качестве целевой.
+3. Регулярно синхронизируйте ветку `dev` с локальной средой, чаще используйте `git pull`.
### Среда разработки
@@ -215,7 +222,7 @@ git switch dev # Переключиться на ветку разработки
pip install pre-commit # или uv tool install pre-commit
pre-commit install
```
-Рекомендуется использовать uv для локальной установки и тестирования:
+Рекомендуется использовать `uv` для локальной установки и тестирования:
```bash
uv tool install -e . --force
astrbot init
@@ -239,7 +246,7 @@ bun dev
- Группа 6: 753075035
- Группа 7: 743746109
- Группа 8: 1030353265
-- Группа разработчиков (Болталка): 975206796
+- Группа разработчиков (Неформальное общение): 975206796
- Группа разработчиков (Официальная): 1039761811
### Канал Discord
@@ -254,24 +261,24 @@ bun dev
-Кроме того, рождение этого проекта было бы невозможно без помощи следующих проектов с открытым исходным кодом:
+Кроме того, рождение этого проекта было бы невозможным без помощи следующих проектов с открытым исходным кодом:
- [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-приложение интеллектуального ИИ-помощника
+- [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) - Отличный антропоморфный AI ChatBot
+- [nekro-agent](https://github.com/KroMiose/nekro-agent) - Отличный агентский ChatBot
+- [LangBot](https://github.com/langbot-app/LangBot) - Отличный мультиплатформенный AI ChatBot
+- [ChatLuna](https://github.com/ChatLunaLab/chatluna) - Отличный плагин мультиплатформенного AI ChatBot для Koishi
+- [Operit AI](https://github.com/AAswordman/Operit) - Отличное Android-приложение интеллектуального AI-помощника
-## ⭐ Star History
+## ⭐ История звезд
> [!TIP]
-> Если этот проект помог вам в жизни или работе, или если вас интересует его будущее развитие, пожалуйста, поставьте проекту звезду (Star). Это наша мотивация для поддержки этого проекта с открытым исходным кодом <3
+> Если этот проект помог вам в жизни или работе, или если вы заинтересованы в будущем развитии этого проекта, пожалуйста, поставьте проекту звезду (Star). Это наша мотивация поддерживать этот проект с открытым исходным кодом <3
@@ -281,9 +288,9 @@ bun dev
-_Общение и способности никогда не должны быть противоположностями. Мы надеемся создать робота, который сможет понимать эмоции, составлять компанию и надежно выполнять задачи._
+_Компаньонство и способности никогда не должны быть противоположностями. Мы надеемся создать робота, который сможет одновременно понимать эмоции, быть компаньоном и надежно выполнять работу._
-_私は、高性能ですから!_
+_私は、高性能ですから!_ (Я высокопроизводительный!)
diff --git a/README_zh-TW.md b/README_zh-TW.md
index 39fb9de242..c50fcb5efe 100644
--- a/README_zh-TW.md
+++ b/README_zh-TW.md
@@ -3,7 +3,7 @@
- [](https://star-history.com/#astrbotdevs/astrbot&Date)
+[](https://star-history.com/#astrbotdevs/astrbot&Date)
-