Skip to main content

A Python-powered slideshow maker with steroids.

Project description


PyPI - License PyPI - Python Version PyPI Travis (.org) Codecov Gitter Demo

A Python-powered slideshow creator with steroids.

See the demo at

What's this about

Auditorium is a Python-powered slideshow generator. You write pure Python code, and obtain an HTML+JavaScript slideshow (using the amazing reveal.js library). The awesomeness comes from the fact that your Python backend is connected to the slideshow frontend, which allows your slideshow to dynamically change according to user input or automatically.

This opens the door to a few interesting use cases:

  • The slides content itself can be generated by code. For example, long and repetitive sets of slides can be automatically generated, or tables and graphs embedded in slides can be generated on-the-fly with matplotlib, bokeh, altair, plotly, or any visualization package that produces HTML output.
  • You can insert components in the slides that respond to user input, and execute a Python code in response. For example, you can generate an interactive graph that can be modified by moving sliders in a slideshow.
  • You can create beautiful animations with simple Python code, that automatically play on a slide, using visualization libraries or simple HTML markup.

And all of this without writing a single line of HTML or JavaScript.

Alternatively, if you need little to no Python code, you can author your slideshow in pure Markdown and add some Python sprinkless here and there when necessary.


Simply run:

pip install auditorium[server]

To see a quick demo run:

auditorium demo

And point your browser at localhost:6789.

Quick Start and Tutorials

If you want to quickly grok auditorium, the best option is to look at the demo online and then read the source code. This way you will both see the end result and what effort it takes to get there.

Made with Auditorium

  • Auditorium Demo - a slideshow showcasing the most important features from auditorium.

Your Contributions Here

If you have a slideshow to showcase here, feel free to edit this Readme and send a pull request. Add your website, Github repository, and any other information.

If you feel like sending some support please consider adding a badge somewhere in your website or repository:

<a href="">
    <img alt="Made with Auditorium"

It looks like this:

Made with Auditorium


See the docs.

Collaboration and License

License is MIT, so you know the drill: fork, develop, add tests, pull request, rinse and repeat. See collaboration details in the docs.

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 auditorium, version 20.2.1
Filename, size File type Python version Upload date Hashes
Filename, size auditorium-20.2.1-py3-none-any.whl (2.6 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size auditorium-20.2.1.tar.gz (2.6 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page