mirror of
https://github.com/AstrBotDevs/AstrBot
synced 2026-07-18 18:10:37 +08:00
290 lines
16 KiB
Markdown
290 lines
16 KiB
Markdown
|
||
|
||
<div align="center">
|
||
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">English</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh-TW.md">繁體中文</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md">日本語</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md">Français</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a>
|
||
|
||
<div>
|
||
<a href="https://trendshift.io/repositories/12875" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12875" alt="Soulter%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
|
||
<a href="https://hellogithub.com/repository/AstrBotDevs/AstrBot" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d127d50cd5e54c5382328acc3bb25483&claim_uid=ZO9by7qCXgSd6Lp&t=2" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<div>
|
||
<img src="https://img.shields.io/github/v/release/AstrBotDevs/AstrBot?color=76bad9" href="https://github.com/AstrBotDevs/AstrBot/releases/latest">
|
||
<img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
|
||
<img src="https://deepwiki.com/badge.svg" href="https://deepwiki.com/AstrBotDevs/AstrBot">
|
||
<a href="https://zread.ai/AstrBotDevs/AstrBot" target="_blank"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="zread"/></a>
|
||
<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?color=76bad9"/></a>
|
||
<img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.soulter.top%2Fastrbot%2Fplugin-num&query=%24.result&suffix=%20Plugins&label=March%C3%A9&cacheSeconds=3600">
|
||
<img src="https://gitcode.com/Soulter/AstrBot/star/badge.svg" href="https://gitcode.com/Soulter/AstrBot">
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<a href="https://astrbot.app/">Accueil</a> ｜
|
||
<a href="https://astrbot.app/">Documentation</a> ｜
|
||
<a href="https://blog.astrbot.app/">Blog</a> ｜
|
||
<a href="https://astrbot.featurebase.app/roadmap">Feuille de route</a> ｜
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/issues">Problèmes</a>
|
||
<a href="mailto:community@astrbot.app">Email</a>
|
||
|
||
</div>
|
||
|
||
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).
|
||
|
||
<br>
|
||
|
||
<table align="center">
|
||
<tr align="center">
|
||
<th>💙 Jeu de rôle & Compagnonnage</th>
|
||
<th>✨ Agent Proactif</th>
|
||
<th>🚀 Capacités Agentic Générales</th>
|
||
<th>🧩 1000+ Plugins Communautaires</th>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><p align="center"><img width="984" height="1746" alt="99b587c5d35eea09d84f33e6cf6cfd4f" src="https://github.com/user-attachments/assets/89196061-3290-458d-b51f-afa178049f84" /></p></td>
|
||
<td align="center"><p align="center"><img width="976" height="1612" alt="c449acd838c41d0915cc08a3824025b1" src="https://github.com/user-attachments/assets/f75368b4-e022-41dc-a9e0-131c3e73e32e" /></p></td>
|
||
<td align="center"><p align="center"><img width="974" height="1732" alt="image" src="https://github.com/user-attachments/assets/e22a3968-87d7-4708-a7cd-e7f198c7c32e" /></p></td>
|
||
<td align="center"><p align="center"><img width="976" height="1734" alt="image" src="https://github.com/user-attachments/assets/0952b395-6b4a-432a-8a50-c294b7f89750" /></p></td>
|
||
</tr>
|
||
</table>
|
||
|
||
## Démarrage Rapide
|
||
|
||
### 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` ⚡️.
|
||
|
||
```bash
|
||
uv tool install astrbot
|
||
astrbot init # Exécutez cette commande uniquement la première fois pour initialiser l'environnement
|
||
astrbot run
|
||
```
|
||
|
||
> 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).
|
||
|
||
Mettre à jour `astrbot` :
|
||
|
||
```bash
|
||
uv tool upgrade astrbot
|
||
```
|
||
|
||
### Déploiement Docker
|
||
|
||
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.
|
||
|
||
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 sur RainYun
|
||
|
||
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 ☁️ :
|
||
|
||
[](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
|
||
|
||
### Déploiement Client de Bureau
|
||
|
||
Pour les utilisateurs souhaitant utiliser AstrBot sur ordinateur et utilisant principalement ChatUI comme point d'entrée, nous recommandons AstrBot App.
|
||
|
||
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éploiement via Lanceur
|
||
|
||
Toujours sur ordinateur, pour les utilisateurs souhaitant déployer rapidement et isoler l'environnement pour plusieurs instances, nous recommandons AstrBot Launcher.
|
||
|
||
Allez sur [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) pour télécharger et installer.
|
||
|
||
### Déploiement sur Replit
|
||
|
||
Le déploiement Replit est maintenu par la communauté et convient aux démonstrations en ligne et aux essais légers.
|
||
|
||
[](https://repl.it/github/AstrBotDevs/AstrBot)
|
||
|
||
### AUR
|
||
|
||
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
|
||
```
|
||
|
||
**Plus de méthodes de déploiement**
|
||
|
||
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é |
|
||
|
||
## Fournisseurs de modèles pris en charge
|
||
|
||
| 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) |
|
||
|
||
## ❤️ 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 à 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.
|
||
|
||
### 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 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 ❤️
|
||
|
||
<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot&max=200&columns=14" />
|
||
</a>
|
||
|
||
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
|
||
|
||
<div align="center">
|
||
|
||
[](https://star-history.com/#astrbotdevs/astrbot&Date)
|
||
|
||
</div>
|
||
|
||
<div align="center">
|
||
|
||
_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._
|
||
|
||
_私は、高性能ですから!_
|
||
|
||
<img src="https://files.astrbot.app/watashiwa-koseino-desukara.gif" width="100"/>
|
||
|
||
</div> |