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!

Wolfram|Alpha module for Sopel IRC bot framework

Project Description

Sopel Wolfram|Alpha module

Wolfram|Alpha module for Sopel IRC bot framework


  • Sopel 6.x
  • wolframalpha 2.4+

Note: Some features are unavailable when run with wolframalpha 2.4. Support for wolframalpha 2.4 is deprecated and will be removed in a future release. All bugs must be reported against sopel-wolfram with wolframalpha 3.0+.


This package’s full name is sopel-modules.wolfram and it is listed on PyPI under that identifier.

The only supported installation method is via pip:

pip install sopel-modules.wolfram

Use pip3 as appropriate for your Python environment.

Development versions can be installed from GitHub via pip also:

pip install git+

Note that pip does not keep track of packages obtained from sources outside of PyPI, so pip install --upgrade sopel-modules.wolfram will not work for GitHub installations. Instead, to upgrade to the latest code, do:

pip install --upgrade git+



The Wolfram|Alpha API requires a key to be added in the bot’s config. Sign up for API access at and add the App ID to Sopel’s configuration file:

app_id = yourappidgoeshere


  • max_public: the number of lines over which results will be sent in NOTICE instead of to the channel (default: 10)
  • units: the measurements to use in results, metric or nonmetric (needs wolframalpha 3.0)


<User> .wa 2+2
<Sopel> [W|A] 2+2 = 4

<User> .wa python language release date
<Sopel> [W|A] Python | date introduced = 1991

<User> .wa airspeed velocity of an unladen swallow
<Sopel> [W|A] estimated average cruising airspeed of an unladen European swallow
        = 25 mph  (miles per hour)(asked, but not answered, about a general
        swallow in the 1975 film Monty Python and the Holy Grail)

A Note About Reloading

In versions of sopel up to 6.5.0 (the last tested version), reloading a third-party module installed from pip, such as wolfram, results in duplicated output. This is a known issue in sopel and is being worked on.

Workaround: After updating sopel-wolfram through pip, restart the bot at your earliest convenience to enable the latest code.


Help with installing or configuring the module is available by pinging either dgw or maxpowa in #sopel on freenode. dgw is also available in #Kaede on Rizon.

Bugs and feature requests can be submitted to the GitHub issue tracker, preferably after first bringing them up on IRC.


Ticket numbers in changelog entries can be looked up by visiting<number>

sopel-wolfram v0.4.0 “Mirai no kajitsu”


  • Support for wolframalpha 3.0 with transitional fallback to 2.4 (#11, #19; see README notes)
  • New configuration option max_public, a number defining the maximum number of lines that can be sent without using NOTICEs. Default: 5 (#13)
  • New configuration option units, to specify whether the API should return metric (default) or nonmetric measurements (#18; see #16)


  • Threshold for using NOTICEs is now 5 lines, up from the previous default of 3


  • Non-ASCII text in output is no longer \:encoded (#15)

sopel-wolfram v0.3.1 “Nusumareta kuchibiru”


  • Unicode-encode query to avoid UnicodeEncodeError on non-ASCII characters (#10)

sopel-wolfram v0.3.0 “So long!”


  • Results longer than 3 lines will be sent via NOTICE instead of flooding channels (#8)

sopel-wolfram v0.2.1 “Mae shika mukanee”


  • Output now split into multiple messages when line breaks are present (#4)
  • Tell pip we do not want wolframalpha 3.0 yet (#6)

sopel-wolfram v0.2.0 “Miraibashi”


  • Try a lot harder to give useful output (#3)
  • Tell user to try again if an unspecified error occurs (empty error message)


  • Cleanup: PEP8 & unused imports
  • Refactor to make future addition of integration tests easier

sopel-wolfram v0.1.2 “Switch”


  • Shorten some error messages
  • Identify as “[W|A]” instead of “[Wolfram]” in output for brevity
  • Ensure all module output is prefixed
  • Add more examples to help output and README


  • README now includes installation instructions and where to get help/report bugs

sopel-wolfram v0.1.1 “Already”


  • Now outputs error if app_id is missing (#1)


  • README reformatted (thanks @maxpowa)
  • Begin maintaining version history in NEWS file

sopel-wolfram v0.1.0 “Beginner”

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


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.wolfram-0.4.0-py2-none-any.whl (10.2 kB) Copy SHA256 Checksum SHA256 py2 Wheel Jul 18, 2017
sopel_modules.wolfram-0.4.0-py2.py3-none-any.whl (10.2 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Jul 18, 2017
sopel_modules.wolfram-0.4.0-py3-none-any.whl (10.2 kB) Copy SHA256 Checksum SHA256 py3 Wheel Jul 18, 2017
sopel_modules.wolfram-0.4.0.tar.gz (6.8 kB) Copy SHA256 Checksum SHA256 Source Jul 18, 2017

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