17 KiB
English | 繁體中文 | 日本語 | 简体中文 | Русский
Accueil | Documentation | Blog | Feuille de route | Signaler un problème Email
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.
Fonctionnalités Principales
- 💯 Gratuit & Open Source.
- ✨ 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.
- 🤖 Prend en charge l'intégration avec des plateformes d'agents comme Dify, Alibaba Bailian, Coze, etc.
- 🌐 Multiplateforme, prend en charge QQ, WeCom, Lark, DingTalk, Compte Officiel WeChat, Telegram, Slack et plus encore.
- 📦 Extension par plugins, plus de 1000 plugins disponibles pour une installation en un clic.
- 🛡️ Agent Sandbox : 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é.
- 💻 Support WebUI.
- 🌈 Support Web ChatUI, avec sandbox de proxy intégré, recherche web, etc.
- 🌐 Support de l'internationalisation (i18n).
| 💙 Jeu de rôle & Accompagnement émotionnel | ✨ Agent Proactif | 🚀 Capacités Agentic Génériques | 🧩 1000+ Plugins Communautaires |
|---|---|---|---|
Démarrage Rapide
Déploiement en un clic
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 ⚡️.
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
# 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
Nécessite l'installation de uv.
Note
Pour les utilisateurs de macOS : en raison des contrôles de sécurité de macOS, la première exécution de la commande
astrbotpeut prendre un certain temps (environ 10-20 secondes).
Mettre à jour astrbot :
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.
Déploiement sur RainYun
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 Client Bureau
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.
Rendez-vous sur 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.
Déploiement Launcher
É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.
Rendez-vous sur AstrBot Launcher pour télécharger et installer.
Déploiement sur Replit
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.
AUR
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.
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 (installation via le magasin d'applications BT Panel), 1Panel (installation via le magasin d'applications 1Panel), CasaOS (déploiement visuel pour NAS / serveur domestique) et Déploiement Manuel (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 |
|---|---|
| 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 | Communauté |
| KOOK | Communauté |
| VoceChat | Communauté |
Fournisseurs de Modèles Pris en Charge
| 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 | LLM (Passerelle API, supporte tous les modèles) |
| Uyun AI | LLM (Passerelle API, supporte tous les modèles) |
| SiliconFlow | LLM (Passerelle API, supporte tous les modèles) |
| PPIO | LLM (Passerelle API, supporte tous les modèles) |
| 302.AI | LLM (Passerelle API, supporte tous les modèles) |
| TokenPony | 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) |
❤️ 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 :
- Créez votre branche de travail basée sur la branche
dev, évitez de travailler directement sur la branchemain. - Lors de la soumission d'une PR, sélectionnez la branche
devcomme cible. - Synchronisez régulièrement la branche
deven local, utilisez souventgit pull.
Environnement de Développement
AstrBot utilise ruff pour le formatage et la vérification du code.
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.
uv tool install -e . --force
astrbot init
astrbot run
Débogage frontend
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
❤️ 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 - Le grand framework félin
Liens amicaux vers des projets open source :
- NoneBot2 - Excellent framework de ChatBot asynchrone en Python
- Koishi - Excellent framework de ChatBot en Node.js
- MaiBot - Excellent ChatBot IA anthropomorphe
- nekro-agent - Excellent ChatBot Agent
- LangBot - Excellent ChatBot IA multiplateforme
- ChatLuna - Excellent plugin Koishi de ChatBot IA multiplateforme
- Operit AI - 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
