Errbot est un chatbot. Il vous permet de démarrer les scripts de manière interactive de vos salons de discussion pour quelque raison que ce soit: humour aléatoire, chatops, démarrage d'une construction, surveillance des engagements, déclenchant des alertes ...
Il est écrit et facilement extensible à Python.
ERRBOT est disponible en tant que logiciel open source et publié sous la licence GPL V3.
Intégré
Avec des modules complémentaires
Après l'installation initiale et la configuration de sécurité, Errbot peut être administré en discutant simplement avec le bot (chatops).
self['foo'] = 'bar'
persiste la valeur.Si vous avez:
Vous pouvez également nous cingler sur Twitter avec le hashtag #errbot
.
Errbot s'exécute sous Python 3.6+ sur Linux, Windows et Mac. Pour certains systèmes de chat, vous aurez besoin d'une clé ou d'une connexion pour que votre bot y accéde.
Nous vous recommandons de configurer un virtualenv.
$ pip install errbot
$ mkdir errbot ; cd errbot
$ errbot --init
$ errbot
Il vous montrera une invite >>> afin que vous puissiez parler directement à votre bot! Essayez! Aidez pour commencer.
Pour les intégrés, utilisez simplement l'un de ces options télégramme, IRC, XMPP avec PIP, vous pouvez toujours le faire après l'installation initiale pour ajouter la prise en charge manquante par exemple
$ pip install "errbot [IRC]"
Pour les externes (Slack, Discord, Gitter, Skype, etc ...), veuillez suivre leurs pages GitHub respectives pour des instructions.
Afin de configurer Errbot pour vous connecter à l'un de ces systèmes de chat, vous devrez modifier le fichier config.py généré par Errbot - init.
Pour vous aider, nous avons un modèle documenté disponible ici: config-template.py.
Remarque: Même si vous avez modifié le backend à partir de la configuration, vous pouvez toujours utiliser Errbot -T pour tester votre instance localement en mode texte.
Si tout cela a fonctionné, vous pouvez maintenant utiliser le paramètre -d (ou --daemon) pour l'exécuter en mode détaché:
errbot --daemon
Après avoir commencé ERRBOT, vous devez ajouter le bot à votre liste de copains si vous ne l'avez pas déjà fait. Vous devrez également inviter le bot dans les salles de chat sur certains systèmes de chat. Vous pouvez maintenant envoyer des commandes directement au bot!
Pour obtenir une liste de toutes les commandes disponibles, vous pouvez émettre:
! help
Si vous souhaitez simplement en savoir plus sur une commande spécifique, vous pouvez émettre:
! help command
Vous pouvez administrer le bot dans un chat en tête-à-tête si votre poignée est dans la liste Bot_Admins dans config.py.
Par exemple, à la recherche de mots clés dans les références du plugin public que vous pouvez émettre:
! repos search jira
Pour installer un plugin à partir de cette liste, problème:
! repos install < name of repo >
Par exemple! Repos Installer Errbotio / err-iMageBot.
Écrire vos propres plugins est extrêmement simple. ERRBOT - Init aura installé dans le sous-répertoire des plugins Un plugin appelé err-Example que vous pouvez utiliser comme base.
À titre d'exemple, c'est tout ce qu'il faut pour créer un "Hello, World!" Plugin pour errbot:
from errbot import BotPlugin , botcmd
class Hello ( BotPlugin ):
"""Example 'Hello, world!' plugin for Errbot"""
@ botcmd
def hello ( self , msg , args ):
"""Return the phrase "Hello, world!" to you"""
return "Hello, world!"
Ce plugin créera la commande "! Bonjour" qui, une fois publiée, retourne "Bonjour, monde!" pour vous. Pour plus d'informations sur tout ce que vous pouvez faire avec les plugins, consultez le Guide de développement des plugins.
N'hésitez pas à se nourrir et à proposer des modifications sur GitHub