Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Sopel module for Habitica

Project Description

# Sopel Habitica Module [Sopel][1] IRC bot module for [Habitica][2]

The chosen unicode icons look best with [good emoji support][3].

## Features

Working so far:

  • Echoes Habitica party chat into IRC
  • Talk in chat from IRC
  • .hero command displays character status
  • Shows nick colors
  • Disable colors (not recommended)
  • Renders markdown code blocks in colors (if enabled)

Planned Features:

  • Cast spells from IRC
  • Use Health potion from IRC
  • Autoheal

Maybe Features:

  • Add Habits/Dailies/Todos
  • Up/Down/Complete Habits/Dailies/Todos/Checklists

## Installation

Clone this repository, open a terminal in the directory you cloned it to and run pip install .. Soon to be found in pypi, too!

## Configuration

Edit your Sopel config file (normally .sopel/default.cfg).

Under [core] add habitica to enable= to enable the module.

Then put in this section

` [habitica] api_user = <a Habitica User ID> api_key = <the corresponding API Token> channels = <comma separated list of IRC channels you want a Habitica chat in> chats = <comma separated list of Habitca chat IDs (see below)> `

Those are the mandatory configuration lines. chats= can contain either the UUID of a chat, or party for your current party’s chat or habitrpg for the Tavern chat.

### Optional configuration

The following lines optionally go in the [habitica] section, the values behind them are the default values:

` max_lines = 5 colors = True api_url = `

max_lines is the number of lines (each of which is limited to 400 characters) each IRC message can be long. colors can be set to False to deactivate the colors for this module. Makes it much harder to read, though! api_url is the url of the Habitica API. If you have your own version of Habitica running, you might want to change it.


  • Tests
  • Documentation

[1]: [2]: [3]:

Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
sopel_modules.habitica-0.1.0.tar.gz (7.1 kB) Copy SHA256 Checksum SHA256 Source May 19, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting