Skip to main content

Errbot is a chatbot designed to be simple to extend with plugins written in Python.

Project description Latest Version License Join the chat at

'Throughput Graph'


Errbot is a chatbot. It allows you to start scripts interactively from your chatrooms for any reason: random humour, chatops, starting a build, monitoring commits, triggering alerts…

It is written and easily extensible in Python.

Errbot is available as open source software and released under the GPL v3 license.



After the initial installation and security setup, Errbot can be administered by just chatting to the bot (chatops).

  • install/uninstall/update/enable/disable private or public plugins hosted on git
  • plugins can be configured from chat
  • direct the bot to join/leave Multi User Chatrooms (MUC)
  • Security: ACL control feature (admin/user rights per command)
  • backup: an integrated command !backup creates a full export of persisted data.
  • logs: can be inspected from chat or streamed to Sentry.

Developer features

  • Very easy to extend in Python ! (see below)
  • Presetup storage for every plugin i.e. self['foo'] = 'bar' persists the value.
  • Conversation flows to track conversation states from users.
  • Webhook callbacks support
  • supports markdown extras formatting with tables, embedded images, links etc.
  • configuration helper to allow your plugin to be configured by chat
  • Graphical and text development/debug consoles
  • Self-documenting: your docstrings becomes help automatically
  • subcommands and various arg parsing options are available (re, command line type)
  • polling support: your can setup a plugin to periodically do something
  • end to end test backend
  • card rendering under Slack and Hipchat.

Community and support

If you have:

For more general discussion and annoucements, you can join us on google plus community. You can also ping us on Twitter with the hashtag #errbot.



Errbot runs under Python 3.3+ on Linux, Windows and Mac. For some chatting systems you’ll need a key or a login for your bot to access it. Note: Python 2 support is still supported in errbot-4.2.x but is it going away.


We recommend to setup a virtualenv.

  1. Install errbot from pip
  2. Make a directory somewhere (here called errbot) to host Errbot’s data files
  3. Initialize the directory
  4. Try out Errbot in text mode
$ pip install errbot
$ mkdir errbot; cd errbot
$ errbot --init
$ errbot

It will show you a prompt >>> so you can talk to your bot directly ! Try !help to get started.

Adding support for a chat system

For the built-ins, just use one of those options slack, hipchap, telegram, IRC, XMPP with pip, you can still do it after the initial installation to add the missing support for example

$ pip install "errbot[slack]"

For the external ones (Skype, Gitter, Discord etc …), please follow their respective github pages for instructions.


In order to configure Errbot to connect to one of those chat system you’ll need to tweak the file generated by errbot –init.

To help you, we have a documented template available here:

Note, even if you changed the BACKEND from the configuration, you can still use errbot -T and errbot -G to test out your instance locally (in text and graphic mode respectively).

Starting Errbot as a daemon

If all that worked, you can now use the -d (or –daemon) parameter to run it in a detached mode:

errbot --daemon

Interacting with the Bot

After starting Errbot, you should add the bot to your buddy list if you haven’t already. You’ll need to invite the bot explicitely to chatrooms on some chat systems too. You can now send commands directly to the bot !

To get a list of all available commands, you can issue:


If you just wish to know more about a specific command you can issue:

!help command

Managing plugins

You can administer the bot in a one-on-one chat if your handle is in the BOT_ADMINS list in

For example to keyword search in the public plugin repos you can issue:

!repos search jira

To install a plugin from this list, issue:

!repos install <name of repo>

For example !repos install errbotio/err-imagebot.

Writing plugins

Writing your own plugins is extremely simple. errbot –init will have installed in the plugins subdirectory a plugin called err-example you can use as a base.

As an example, this is all it takes to create a “Hello, world!” plugin for Errbot:

from errbot import BotPlugin, botcmd

 class Hello(BotPlugin):
     """Example 'Hello, world!' plugin for Errbot"""

     def hello(self, msg, args):
         """Return the phrase "Hello, world!" to you"""
         return "Hello, world!"

This plugin will create the command “!hello” which, when issued, returns “Hello, world!” to you. For more info on everything you can do with plugins, see the plugin development guide.

Contribution to Errbot itself

Feel free to fork and propose changes on github

v4.3.2 (2016-09-04)


  • removed the hard dependency on pytest for the Text backend

v4.3.1 (2016-09-03)


  • now the threadpool is of size 10 by default and added a configuration.


  • fixed imporlib/use pip as process (#835) (thx Raphael Wouters)
  • if pip is not found, don’t crash errbot
  • build_identifier to send message to IRC channels (thx mr Shu)

v4.3.0 (2016-08-10)

v4.3 New features

  • DependsOn: entry in .plug and self.get_plugin(…) allowing you to make a plugin dependent from another.
  • New entry in PLUGINS_CALLBACK_ORDER allows you to force a callback order on your installed plugins.
  • Flows can be shared by a room if you build the flow with FlowRoot(room_flow=True) (thx Tobias Wilken)
  • New construct for persistence: with self.mutable(key) as value: that allows you to change by side effect value without bothering to save value back.

v4.3 Miscellaneous changes

  • This version work only on Python 3.4+ (see 4.2 announcement)
  • Presence.nick is deprecated, simply use presence.identifier.nick instead.
  • Slack: Bot identity is automatically added to BOT_ALT_PREFIXES
  • The version checker now reports your Python version to be sure to not upgrade Python 2 users to 4.3
  • Moved testing to Tox. We used to use a custom script, this improves a lot the local testing setup etc. (Thx Pedro Rodrigues)

v4.3 bugs fixes

  • Slack: Mention callback improvements (Thx Ash Caire)
  • Encoding error report was inconsistent with the value checked (Thx Steve Jarvis)
  • core: better support for all the types of virtualenvs (Thx Raphael Wouters)

v4.2.2 (2016-06-24)


  • send_templated fix
  • Blacklisting feedback message corrected

v4.2.1 (2016-06-10)


  • packaging failure under python2
  • better README

v4.2.0 (2016-06-10)

v4.2 Announcement

  • Bye bye Python 2 ! This 4.2 branch will be the last to support Python 2. We will maintain bug fixes on it for at least the end of 2016 so you can transition nicely, but please start now !

    Python 3 has been released 8 years ago, now all the major distributions finally have it available, the ecosystem has moved on too. This was not the case at all when we started to port Errbot to Python 3.

    This will clean up a lot of code with ugly if PY2, unicode hacks, 3to2 reverse hacks all over the place and packaging tricks. But most of all it will finally unite the Errbot ecosystem under one language and open up new possibilities as we refrained from using py3 only features.

  • A clarification on Errbot’s license has been accepted. The contributors never intended to have the GPL licence be enforced for external plugins. Even if it was not clear it would apply, our new licence exception makes sure it isn’t. Big big thanks for the amazing turnout on this one !

v4.2 New features

  • Errbot initial installation. The initial installation has been drastically simplified:

    $ pip install errbot
    $ mkdir errbot; cd errbot
    $ errbot --init
    $ errbot -T
    >>>     <- You are game !!

    Not only that but it also install a development directory in there so it now takes only seconds to have an Errbot development environment.

  • Part of this change, we also made most of the entries with sane defaults, a lot of those settings were not even relevant for most users.

  • cards are now supported on the graphic backend with a nice rendering (errbot -G)

  • Hipchat: mentions are now supported.

v4.2 Miscellaneous changes

  • Documentation improvements
  • Reorganization and rename of the startup files. Those were historically the first ones to be created and their meaning drifted over the years. We had, and, it was really not clear what were their functions and why one has been violating the python module naming convention for so long :) They are now (everything about configuring errbot), (everything about the errbot command line) and finally (everything about the commands, and dispatching etc…).
  • cleanup. The hacks in there were incorrect.

v4.2 bugs fixes

  • core: excpetion formatting was failing on some plugin load failures.
  • core: When replacing the prefix ! from the doctrings only real commands get replaced (thx Raphael Boidol)
  • core: empty lines on plugins requirements.txt does crash errbot anymore
  • core: Better error message in case of malformed .plug file
  • Text: fix on build_identifier (thx Pawet Adamcak)
  • Slack: several fixes for identifiers parsing, the backend is fully compliant with Errbot’s contract now (thx Raphael Boidol and Samuel Loretan)
  • Hipchat: fix on room occupants (thx Roman Forkosh)
  • Hipchat: fix for organizations with more than 100 rooms. (thx Naman Bharadwaj)
  • Hipchat: fixed a crash on build_identifier

v4.1.3 (2016-05-10)


bugs: - Slack: regression on build_identifier - Hipchat: regression on build_identifier (query for room is not supported)

v4.1.2 (2016-05-10)


bugs: - cards for hipchat and slack were not merged.

v4.1.1 (2016-05-09)



  • Python 2.7 conversion error on

v4.1.0 (2016-05-09)

v4.1 New features

  • Conversation flows: Errbot can now keep track of conversations with its users and automate part of the interactions in a state machine manageable from chat. see the flows documentation for more information.
  • Cards API: Various backends have a “canned” type of formatted response. We now support that for a better native integration with Slack and Hipchat.
  • Dynamic Plugins API: Errbot has now an official API to build plugins at runtime (on the fly). see the dynamic plugins doc
  • Storage command line interface: It is now possible to provision any persistent setting from the command line. It is helpful if you want to automate end to end the deployment of your chatbot. see provisioning doc

v4.1 Miscellaneous changes

  • Now if no [python] section is set in the .plug file, we assume Python 3 instead of Python 2.
  • Slack: identifier.person now gives its username instead of slack id
  • IRC: Topic change callback fixed. Thx Ezequiel Brizuela.
  • Text/Test: Makes the identifier behave more like a real backend.
  • Text: new TEXT_DEMO_MODE that removes the logs once the chat is started: it is made for presentations / demos.
  • XMPP: build_identifier can now resolve a Room (it will eventually be available on other backends)
  • Graphic Test backend: renders way better the chat, TEXT_DEMO_MODE makes it full screen for your presentations.
  • ACLs: We now allow a simple string as an entry with only one element.
  • Unit Tests are now all pure py.test instead of a mix of (py.test, nose and unittest)

v4.1 Bugs fixed

  • Better resillience on concurrent modifications of the commands structures.
  • Allow multiline table cells. Thx Ilya Figotin.
  • Plugin template was incorrectly showing how to check config. Thx Christian Weiske.
  • Slack: DIVERT_TO_PRIVATE fix.
  • Plugin Activate was not reporting correctly some errors.
  • tar.gz packaged plugins are working again.

v4.0.3 (2016-03-17)



  • XMPP backend compatibility with python 2.7
  • Telegram startup error
  • daemonize regression
  • UTF-8 detection

v4.0.2 (2016-03-15)



  • configparser needs to be pinned to a 3.5.0b2 beta
  • Hipchat regression on Identifiers
  • Slack: avoid URI expansion.

v4.0.1 (2016-03-14)

Hotfixes for 4.0.0.


  • v4 doesn’t migrate plugin repos entries from v3.
  • py2 compatibility.

v4.0.0 (2016-03-13)

This is the next major release of errbot with significant changes under the hood.

v4.0 New features

  • Storage is now implemented as a plugin as well, similar to command plugins and backends. This means you can now select different storage implementations or even write your own.

The following storage backends are currently available:

  • The traditional Python shelf storage.
  • In-memory storage for tests or ephemeral storage.
  • SQL storage which supports relational databases such as MySQL, Postgres, Redshift etc.
  • Firebase storage for the Google Firebase DB.
  • Redis storage (thanks Sijis Aviles!) which uses the Redis in-memory data structure store.
  • Unix-style glob support in BOT_ADMINS and ACCESS_CONTROLS (see the updated for documentation).
  • The ability to apply ACLs to all commands exposed by a plugin (see the updated for documentation).
  • The mention_callcack() on IRC (mr. Shu).
  • A new (externally maintained) Skype backend.
  • The ability to disable core plugins (such as !help, !status, etc) from loading (see CORE_PLUGINS in the updated
  • Added a –new-plugin flag to errbot which can create an emply plugin skeleton for you.
  • IPv6 configuration support on IRC (Mike Burke)
  • More flexible access controls on IRC based on nickmasks (in part thanks to Marcus Carlsson). IRC users, see the new IRC_ACL_PATTERN in
  • A new callback_mention() for plugins (not available on all backends).
  • Admins are now notified about plugin startup errors which happen during bot startup
  • The repos listed by the !repos command are now fetched from a public index and can be queried with !repos query [keyword]. Additionally, it is now possible to add your own index(es) to this list as well in case you wish to maintain a private index (special thanks to Sijis Aviles for the initial proof-of-concept implementation).

v4.0 Bugs fixed

  • IRC backend no longer crashes on invalid UTF-8 characters but instead replaces them (mr. Shu).
  • Fixed joining password-protected rooms (Mikko Lehto)
  • Compatibility to API changes introduced in slackclient-1.0.0 (used by the Slack backend).
  • Corrected room joining on IRC (Ezequiel Hector Brizuela).
  • Fixed “team_join event handler raised an exception” on Slack.
  • Fixed DIVERT_TO_PRIVATE on HipChat.
  • Fixed DIVERT_TO_PRIVATE on Slack.
  • Fixed GROUPCHAT_NICK_PREFIXED not prefixing the user on regular commands.
  • Fixed HIDE_RESTRICTED_ACCESS from accidentally sending messages when issuing !help.
  • Fixed markdown rendering breaking with GROUPCHAT_NICK_PREFIXED enabled.
  • Fixed AttributeError with AUTOINSTALL_DEPS enabled.
  • IRC backend now cleanly disconnects from IRC servers instead of just cutting the connection.
  • Text mode now displays the prompt beneath the log output
  • Plugins which fail to install no longer remain behind, obstructing a new installation attempt

v4.0 Breaking changes

  • The underlying implementation of Identifiers has been drastically refactored to be more clear and correct. This makes it a lot easier to construct Identifiers and send messages to specific people or rooms.
  • The file format for –backup and –restore has changed between 3.x and 4.0 On the v3.2 branch, backup can now backup using the new v4 format with !backupv4 to make it possible to use with –restore on errbot 4.0.

A number of features which had previously been deprecated have now been removed. These include:

  • configure_room and invite_in_room in XMPPBackend (use the equivalent functions on the XMPPRoom object instead)
  • The –xmpp, –hipchat, –slack and –irc command-line options from errbot (set a proper BACKEND in instead).

v 4.0 Miscellaneous changes

  • Version information is now specified in plugin .plug files instead of in the Python class of the plugin.
  • Updated !help output, more similar to Hubot’s help output (James O’Beirne and Sijis Aviles).
  • XHTML-IM output can now be enabled on XMPP again.
  • New –version flag on errbot (mr. Shu).
  • Made !log tail admin only (Nicolas Sebrecht).
  • Made the version checker asynchronous, improving startup times.
  • Optionally allow bot configuration from groupchat
  • Message.type is now deprecated in favor of Message.is_direct and Message.is_group.
  • Some bundled dependencies have been refactored out into external dependencies.
  • Many improvements have been made to the documention, both in docstrings internally as well as the user guide on the website at

Further info on identifier changes

  • Person, RoomOccupant and Room are now all equal and can be used as-is to send a message to a person, a person in a Room or a Room itself.

The relationship is as follow:

For example: A Message sent from a room will have a RoomOccupant as frm and a Room as to.

This means that you can now do things like:

  • self.send(msg.frm, “Message”)
  • self.send(self.query_room(“#general”), “Hello everyone”)

v3.2.3 (2016-02-18)


  • IRC: Use the NickMask helper for parsing IRC Identity and proper ACL (thx Marcus Carlsson)
  • IRC: Fix random UnicodeDecodeErrors (thx mr.Shu)
  • XMPP: Fix join on MUCRoom with password (thx Mikko Lehto)
  • XMPP: Fix join on Room list (from CHATROOM_PRESENCE for example) (thx Mikko Lehto)
  • Backup: NullBackend was missing few methods and was crashing.
  • IRC: Synchronize join and joined events

v3.2.2 (2015-12-08)


  • shutdown was not called properly anymore leading to possible plugin configuration loss.
  • fixed tarfile plugin install
  • fixed error reporting on webhook json parsing
  • fixed/hacked so the prompt on text mode appear after the asynchronous log entries


  • added a warning if the system encoding is not utf-8

v3.2.1 (2015-11-15)


  • Pypi fixes.

v3.2.0 (2015-11-13)


  • Official support for Python 3.5
  • The API surface is now type hinted ( and base classes are tagged Abstract.
  • Added send_templated() to the BotPlugin class to be able to use send() with a template
  • Various improvements to the @arg_botcmd decorator.
  • Now the bot can set its own status/presence with change_presence
  • Non-standard hipchat server (thx Barak Schiller)


  • Fixed various bugs with the @arg_botcmd decorator (#516)
  • Fixed warn_admins() on Telegram
  • Slack ACLs now properly check against usernames starting with @
  • Slack identifiers can now be built from a bare #channel string (without a username part)
  • Slack identifiers can now be built from a <#C12345> or <@username> string (the webclient formats them like this automatically when chatting with the bot)
  • HipChat backend now respects the server option under BOT_IDENTITY (#544)
  • The IRC backend will no longer throw UnicodeDecodeError but replaces characters which cannot be decoded as UTF-8 (#570, Mr. Shu)
  • Fixed a bug that would prevent the bot from joining password-protected rooms (#578, Mikko Lehto)


  • various internal improvements and refactoring
  • Removed some dead code
  • Removed deprecated bare_send and invite_to_room bot methods
  • Doc improvements (thx Anita Woodruff)

v3.1.3 (2015-11-12)

updated the version checker to

v3.1.2 (2015-11-05)


  • XMPP: self.send on a mess.frm on XMPP was failing
  • XMPP: reply to a private message from a chatroom was failing
  • blacklist now deactivate automatically a plugin if activated
  • unblacklist new activate automatically a plugin

v3.1.1 (2015-10-26)


  • fix regression on !help (thx kromey)

v3.1.0 (2015-10-22)


  • now setup will install ‘errbot’ in the path instead of ‘’ (thx mr.Shu)
  • new SUPPRESS_CMD_NOT_FOUND to simply ignore a command if it is not found (thx James O’Beirne)
  • err-shellexec in the list of repos (thx Will Fife)
  • msg.extras is a new message property to get extra metadata that doesn’t fit into a traditional message like attachments for Slack (thx James O’Beirne)
  • Terse output
  • IRC: now you can use nickserv to auth the bot (thx mr.Shu)
  • IRC: COMPACT_OUTPUT option allows you to remove the ascii art around the tables.
  • BOT_ADMINS: having a simple string instead of a tuple is possible too (thx mr.Shu)


  • better error message for unblacklisting (thx Sijis)
  • respect optional prefix for re_botcmd (thx Travis Veazey)
  • fix breakage on pytest on deps (thx Joel Perras)
  • !help foo bar for foo_bar fix + cosmetic (thx James O’Beirne)
  • fixed path report for in case of problem
  • yield not work with @arg_botcmd (thx Andre Van Der Merwe)
  • backup/restore fixes

v3.0.4 (2015-09-12)

  • Small cleanup
  • force XMPP to ascii rendering (xhtml-im is beyond broken)
  • Fixed !room list
  • Fixed !room occupants [room] on XMPP

v3.0.3 (2015-08-26)

  • fixed the missing path for relative imports in plugins.
  • better pre rendering on graphic backend
  • better !log tail rendering
  • add alt as an alternative modifier on graphic backend (it was problematic on MacOS)

v3.0.2 (2015-08-26)

  • multiple fixes for the graphic backend (it is waaay nicer now)
  • missing spots in doc and feedback for for activate/deactivate
  • aclattr fix for the slack backend
  • status uses more of the markdown goodies

v3.0.1 (2015-08-20)

  • bugfix for IRC backend not starting.

v3.0.0 (2015-08-17)

We have decided to promote this release as the v3 \o/.

This document includes all the changes since the last stable version (2.2.0).

If you have any difficulty using this new release, feel free to jump into our dev room on gitter.

v3 New and noteworthy

  • backends are now plugins too
  • new Slack backend (see the config template for details)
  • new Telegram backend
  • new Gitter backend (see the gitter backend repo for more info about installing it)
  • completely new rendering engine: now all text from either a plugin return or a template is markdown extras
  • you can test the various formatting under your backend with the !render test command.
  • the text backend exposes the original md, its html representation and ansi representation so plugin developers can anticipate what the rendering will look like under various backends.

See the screenshots below: Slack, Hipchat, IRC, Gitter and finally Text.

  • completely revamped backup/restore feature (see !help backup).
  • Identifiers are now generic (and not tight to XMPP anymore) with common notions of .person .room (for MUCIdentifiers) .client .nick and .displayname see this doc for details.
  • New !whoami command to debug identity problems for your plugins.
  • New !killbot command to stop your bot remotely in case of emergency.
  • New support for argparse style command arguments with the @arg_botcmd decorator.
  • IRC: file transfer from the bot is now supported (DCC)

Minor improvements

  • hipchat endpoint can be used (#348)
  • XMPP server parameter can be overriden
  • deep internal reorganisation of the bot: the most visible change is that internal commands have been split into internal plugins.
  • IRC backend: we have now a reconnection logic on disconnect and on kick (see IRC_RECONNECT_ON_DISCONNECT in the config file for example)

Stuff that might break you

  • if you upgrade from a previous version, please install: pip install markdown ansi Pygments "pygments-markdown-lexer>=0.1.0.dev29"
  • you need to add the type of backend you use in your config file instead of the command like. i.e. BACKEND = 'XMPP'
  • XMPP properties .node, .domain and .resource on identifiers are deprecated, a backward compatibility layer has been added but we highly encourage you to not rely on those but use the generic ones from now on: .person, .client and for MUCOccupants .room on top of .person and .client.
  • To create identifiers from a string (i.e. if you don’t get it from the bot itself) you now have to use build_identifier(string) to make the backend parse it
  • command line parameter -c needs to be the full path of your config file, it allows us to have different set of configs to test the bot.
  • campfire and TOX backends are now external plugins: see the tox backend repo and the campfire backend repo for more info about installing them.
  • any output from plugin is now considered markdown, it might break some of your output if you had any markup characters (#, -, * …).
  • we removed the gtalk support as it is going away.

Bugs squashed

  • plugin loader do not traverse __pycache__ and dotted directory anymore
  • import error at install time.
  • IRC backend compatibility with gitter
  • Better logging to debug plugin callbacks
  • Better dependency requirements ( vs requirements.txt)
  • builtins are now named core_plugins (the plan is to move more there)
  • a lot of refactoring around globals (it enabled the third party plugins)
  • git should now work under Windows
  • None was documented as a valid value for the IRC rate limiter but was not.
  • removed xep_0004 from the xmpp backend (it was deprecated)

since 3.0.0-rc1:

  • imtext was removing the ` for Slack
  • corrected the leaking <code><pre> in text/ansi
  • fixed a restart loop in Telegram
  • clear formatting in the Slack backend for angle brackets [thx @RobSpectre]
  • XMPP: allow slashes in resources


Rendering under Slack:


Rendering under Hipchat:


Rendering under IRC:


Rendering under Gitter:


Rendering under Text (for plugin development):


v2.3.0-rc2 (2015-07-06)

Bug fixed:

  • import error at install time.

v2.3.0-beta (2015-07-05)

New features:

  • new Slack backend
  • third party backends (they are plugins too)
  • completely revamped backup/restore feature.
  • hipchat endpoint can be used (#348)
  • XMPP server parameter can be overriden
  • Identifiers are now generic (not tight to XMPP anymore)

Bug fixed:

  • IRC backend compatibility with gitter
  • Better logging to debug plugin callbacks
  • Better dependency requirements ( vs requirements.txt)
  • builtins are now named core_plugins (the plan is to move more there)
  • a lot of refactoring around globals (it enabled the third party plugins)

v2.2.1 (2015-05-16)

Bug fixed:

  • hipchat keepalive

v2.2.0 (2015-05-16)

New features:

  • New AUTOINSTALL_DEPS config to autoinstall the dependencies required for plugins

Bug fixed:

  • Don’t 3to2 the config template
  • version pinned yapsy because of an incompatibility with the last version
  • added timeout to the version check builtin

v2.2.0-beta (2015-02-16)

New features:

  • New serverless tox backend (see for more info)
  • New Presence callbacks with status messages etc.
  • New file transfert support (upload and downloads) for selected backends
  • New MUC management API
  • added err-githubhook to the official repo list (thx Daniele Sluijters)
  • added err-linksBot to the official repo list (thx Arnaud Vazard)
  • added err-stash to the official repo list (thx Charles Gomes)
  • shlex.split on split_args_with
  • improved !status command (Thx Sijis Aviles)
  • colorized log output
  • configuration access improvements, it is now a property accessible from the plugins (self.bot_configuration) and the backends.
  • bot can optionally name people it replies to in mucs with local conventions toto: or @toto etc… (thx Sijis Aviles)

Bug fixed:

  • complete pass & fixes with a static analyser
  • better feedback when is borken
  • hipchat has been rewritten and goes through the API
  • more consistency on properties versus setters/getters
  • mac osx fixes (thx Andrii Kostenko)
  • unicode fix on irc backend (thx Sijis Aviles)

v2.1.0 (2014-07-24)


  • Various changes to the test backend:
    • setUp method of FullStackTest now takes an extra_plugin_dir argument, deprecating the extra_test_file argument.
    • popMessage and pushMessage are now more pythonically called pop_message and push_message, though the old names continue to work.
    • New testbot fixture to write tests using pytest.
  • Better display of active plugins in debug info (#262).
  • Allow optional username for IRC backend (#256).
  • Raw option for the webhook API.
  • Regex-based bot commands.
  • Pretty-printed output of the !config command.


  • Fix make_ssl_certificate on Python 2.
  • Newer version of Rocket, fixing an issue with releasing ports on OSX (#268).
  • Only run 3to2 during actual install steps (#232).
  • Ignore messages from self (#247).
  • Import irc.connection within try/except block (#245).
  • Better message recipient setting in XMPP MUC responses.
  • Only configure XMPP MUC when having owner affiliation.
  • Use SleekXMPP plugin xep_0004 instead of deprecated old_0004 (#236).

v2.0.0 (2014-01-05)


  • split load/unload from blacklist/unblacklist
  • provides a better feedback for 3to2 conversion
  • better formatting for plugin list with unicode bullets
  • better formatting for !reload
  • better feedback on case of !reload problems
  • made loglevel configuration (Thx Daniele Sluijters)
  • added err-dnsnative to the plugin list.


  • Fixed a missing callback_connect on plugin activation
  • Forced Python 3.3 as a minimal req for the py3 version as deps break with 3.2
  • Fixed pip installs during
  • warn_admin breakage on python2
  • SSL IRC backend fix
  • Various typos.

v2.0.0-rc2 (2013-11-28)

Migrated the version checker to


  • Fix MUC login: Support tuple & add username
  • Language correction (thx daenney)

v2.0.0-rc1 (2013-10-03)


  • Added err-faustbot to the official repo list
  • Added the !room create command for adhoc room creation (google talk)
  • Added sedbot to the official repos
  • Added support for plugin based webviews
  • Add err-agressive-keepalive to the official repos
  • Allow botcmd’s to yield values
  • Allow configuration of MESSAGE_SIZE_LIMIT


  • Properly close shelf upon restart (thx Max Wagner)
  • Fix inverted display of repo status (private/official) (thx Max Wagner)
  • Include jid resource in Message.from/to (Thx Kha)
  • Fix messed up display of status and repos commands (thx Max Wagner)
  • fixed the standalone execution with -c parameter
  • corrected the QT backend under python 3
  • hipchat fix
  • missing dependencies for SRV records (google compatibility)
  • bug in the apropos while adding a command to chatroom
  • XMPP: forward HTML of incoming messages (Thx Kha)
  • corrected the linkyfier in the graphic interface
  • corrected the status display of a plugin that failed at activation stage
  • Handle disconnect events correctly

v2.0.0-beta (2013-03-31)


  • SSL support for webhook callbacks
  • JID unicode support
  • Per user command history (Thanks to Leonid S. Usov
  • HIDE_RESTRICTED_COMMANDS option added to filter out the non accessoble commands from the help (Thanks to Leonid S. Usov
  • err-markovbot has been added to the official plugins list (Thanks to Max Wagner
  • the version parsing now supports beta, alpha, rc etc … statuses

Major refactoring:

  • python 3 compatibility
  • xmpp backend has been replaced by sleekxmpp
  • flask has been replaced by bottle (sorry flask no py3 support, no future) [edit from 2016: This is not true anymore].
  • rocket is used as webserver with SSL support
  • now the IRC backend uses the smpler python/irc package
  • improved unittest coverage

v1.7.1 (2012-12-25)


  • unicode encoding on jabber

v1.7.0 (2012-12-24)

Incompatible changes:

For this one if your plugin uses PLUGIN_DIR, you will need to change it to self.plugin_dir as it is a runtime value now.


  • yapsy 1.10 compatibility
  • better detection of self in MUC
  • force python 2 for shebang lines
  • Parses the real nick and the room and put it in the from identity of messages
  • fix for JID Instance has no attribute ‘__len__’
  • partial support for @ in JIDs nodes
  • when a plugin was reloaded, it was not connect notified


  • botprefix is now optional on one on one chats
  • fine grained access control
  • better serialization to disk by default (protocol 2)
  • configurable separate rate limiting for IRC for public and private chats
  • added support for MUC with passwords
  • bot prefixes can be of any length
  • modular !help command (it lists the plugin list with no parameters instead of the full command list)

Dev Improvements:

  • better unit tests
  • Travis CI

v1.6.7 (2012-10-08)


  • the XMPP from was not removed as it should and broke the gtalk compatibility
  • fixed ‘jid-malformed’ error with build_reply()


  • new plugin : err-dnsutils
  • Now you can selectively divert chatroom answers from a list of specified commands to a private chat (avoids flooding on IRC for example)
  • the logging can be done using sentry
  • Err can now login using SSL on IRC (thx to Dan Poirier

v1.6.6 (2012-09-27)


  • bot initiated messages were not correctly callbacked on jabber backend
  • !apropos was generating an unicode error thx to for the fix
  • corrected a serie of issues related to the sharedmiddleware on flask
  • fixed a regression on the IRC backend thx to for helping on those


  • added err-mailwatch to the official repo thx to for the contribution
  • added a “null” backend to stabilise the web ui

v1.6.5 (2012-09-10)



  • The graphical backend now uses a multiline chat to better reflect some backends.

v1.6.4 (2012-09-04)

You will need to add 2 new config entries to your See below for details


  • Identity stripping problems
  • fixed warn_admin that regressed
  • close correctly shelves on connection drop [Thx to linux techie]
  • corrected the !status reporting was incorrect for non configured plugins (label C)
  • force a complete reconnection on “See Other Host” XMPP message


  • You can now change the default prefix of the bot (new config BOT_PREFIX) [Thx to Ciaran Gultnieks]
  • Added an optional threadpool to execute commands in parallel (Experimental, new config : BOT_ASYNC)
  • Now the bot waits on signal USR1 so you can do a kill -USR1 PID of err to make it spawn a local python console to debug it live
  • Now you can have several config_*.py, one per backend (to be able to test specifically a backend without having to reconfigure each time the bot)

v1.6.3 (2012-08-26)


  • !reload was causing a crash on templating
  • !update was failing on internal_shelf
  • several consistency fixups around Identity and Message, now they should behave almost the same was across all the backends
  • corrected several unicode / utf-8 issues across the backends
  • unified the standard xmpp and hipchat keep alive, they work the same


  • added err-timemachine, an “history” plugin that logs and indexes every messages. You can query it with a lucene syntax over specific dates etc …
  • Added a webserver UI from the webserver builtin plugin (disabled by default see !config webserver to enable it)
  • Now if a config structure changed or failed, the bot will present you the config you had and the default template so you can adapt your current config easily
  • Added the schema for xhtml-im so you can use your favorite xml editor to check what your templates are generating

v1.6.2 (2012-08-24)



  • Added basic IRC support
  • Now the BOT_EXTRA_PLUGIN_DIR can be a list so you can develop several plugins at the same time

v1.6.1 (2012-08-22)

Simplified the installation.


  • put pyfire as an optional dependency as it is used only for the campfire backend
  • put PySide as an optional dependency as it is used only for the QT graphical backend

v1.6.0 (2012-08-16)


  • corrected a threading issue that was preventing err to quit
  • the python shebangs lines where not generic
  • the config path is not inserted first so we don’t conflict with other installs
  • corrected a corruption of the configs on some persistance stores on shutdown


  • Added support for CampFire
  • Added support for Hipchat API with basic html messages
  • Added support for webhooks
  • Independent backends can be implemented
  • In order to simplify : now botcmd and BotPlugin are both imported from errbot (we left a big fat warning for the old deprecated spot, they will be removed in next release)
  • Better status report from !status (including Errors and non-configured plugins)

v1.5.1 (2012-08-11)


  • the pypi package was not deploying html templates

v1.5.0 (2012-08-10)



  • Added XHTML-IM support with Jinja2 templating
  • Better presentation on the !repos command
  • load / unload of plugins is now persistent (they are blacklisted when unloaded)
  • Better presentation of the !status command : Now you can see loaded, blacklisted and Erroneous plugins from there
  • A new !about command with some credits and the current version
  • Implemented the history navigation in the graphic test mode (up and down)
  • Added an autocomplete in the graphic test mode
  • Added the logo in the background of the graphic mode

v1.4.1 (2012-07-13)


  • corrected a vicious bug when you use metaclasses on plugins with botcmd decorator generated with parameters
  • don’t call any callback message if the message is from the chat history
  • dependency problem with dnspython, it fixes the compatibility with google apps [Thx to linux techie]
  • on repos updates, err now recheck the dependencies (you never know if they changed after the update)


  • Added a new check_configuration callback now by default the configuration check is basic and no implementation has to be done on plugin side
  • Warn the admins in case of command name clashes and fix them by prefixing the name of the plugin + -
  • A brand new graphical mode so you can debug with images displayed etc … (command line option -G) it requires pyside [thx to Paul Labedan]
  • A new !apropos command that search a term into the help descriptions [thx to Ben Van Daele]
  • Now the bot reconnects in case of bad internet connectivity [Thx to linux techie]
  • The bot now supports a “remote chatroom relay” (relay all messages from a MUC to a list of users) on top of a normal relay (from a user to a list of MUC)
    With this you can emulate a partychat mode.
  • err-music [thx to Ben Van Daele and thx to Tali Petrover]

v1.4.0 (2012-07-09)


  • improved the detection of own messages
  • automatic rejection if the configuration failed so it the plugin restart with a virgin config


v1.3.1 (2012-07-02)


  • nicer warning message in case of public admin command


  • added a warn_admins api for the plugins to warn the bot admins in case of serious problem
  • added err-tv in the official repos list
  • added an automatic version check so admins are warned if a new err is out
  • now if a repo has a standard requirements.txt it will be checked upon to avoid admins having to dig in the logs (warning: it added setuptools as a new dependency for err itself)

v1.3.0 (2012-06-26)


  • Security fix : the plugin directory permissions were too lax. Thx to Pinkbyte (Sergey Popov)
  • Corrected a bug in the exit of test mode, the shelves could loose data
  • Added a userfriendly git command check to notify if it is missing


  • Added a version check: plugins can define min_err_version and max_err_version to notify their compatibility
  • Added an online configuration of the plugins. No need to make your plugin users hack the anymore ! just use the command !config
  • Added a minimum Windows support.

v1.2.2 (2012-06-21)


  • Corrected a problem when executing it from the dev tree with ./scripts/
  • Corrected the python-daemon dependency
  • Corrected the encoding problem from the console to better match what the bot will gives to the plugins on a real XMPP server
  • Corrected a bug in the python path for the BOT_EXTRA_PLUGIN_DIR setup parameter


  • Added a dictionary mixin for the plugins themselves so you can access you data directly with self[‘entry’]
  • admin_only is now a simple parameter of @botcmd
  • Implemented the history commands : !history !! !1 !2 !3

v1.2.1 (2012-06-16)


  • Corrected a crash if the bot could not contact the server


  • Added a split_args_with to the botcmd decorator to ease the burden of parsing args on the plugin side
  • Added the pid, uid, gid parameters to the daemon group to be able to package it on linux distributions

v1.2.0 (2012-06-14)


  • Don’t nag the user for irrelevant settings from the setting-template
  • Added a message size security in the framework to avoid getting banned from servers when a plugin spills too much


  • Added a test mode (-t) to ease plugin development (no need to have XMPP client / server to install and connect to in order to test the bot)
  • Added err-reviewboard a new plugin by Glen Zangirolam to the repos list
  • Added subcommands supports like the function log_tail will match !log tail [args]

v1.1.1 (2012-06-12)


  • Fixed the problem updating the core + restart
  • Greatly improved the reporting in case of configuration mistakes.
  • Patched the presence for a better Hipchat interop.

v1.1.0 (2012-06-10)


  • Added the !uptime command
  • !uninstall doesn’t require a full restart anymore
  • !update a plugin doesn’t require a full restart anymore
  • Simplified the usage of the asynchronous self.send() by stripping the last part of the JID for chatrooms
  • Improved the !restart feature so is standalone now (no need to have a anymore)
  • now takes 2 optional parameters : -d to daemonize it and -c to specify the location of the config file

v1.0.4 (2012-06-08)

  • First real release, fixups for Pypi compliance.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for errbot, version 4.3.2
Filename, size File type Python version Upload date Hashes
Filename, size errbot-4.3.2.tar.gz (195.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page