Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Package which adds a PlantUML cell magic to IPython.

Project description

What is it?

This Python package defines a PlantUML cell magic for IPython. It lets you generate UML diagrams as inline SVG in your notebook. I’ll add embellishments as needed. But, for now, I just needed something that worked and existed as a package (in pypi).

I based my code on Steven Burke’s plantuml gist.


First, install IPlantuml with pip.

pip install iplantuml

Then, install plantuml. On Debian based system you can install plantuml package. Otherwise you can download plantuml.jar and copy it to /usr/local/bin/plantuml.jar.

sudo apt install plantuml

Alternatively you can set a custom path for plantuml.jar during installation

git clone
cd IPlantUML
python install iplantuml --jarpath /my/custom/path/plantuml.jar


In Ipython, first,

import iplantuml

then, create a cell like,


Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response

The output will be the generated SVG UML diagram.

By default, the magic removes the intermediate (tmp.uml) and target (tmp.svg) files. However, if you enter a name in the %%plantuml line, it retains both files of $name.uml and $name.svg. For example,

%%plantuml auth

Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response

generates and retains auth.uml and auth.svg.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
IPlantUML-0.1.1.tar.gz (5.5 kB) Copy SHA256 hash SHA256 Source None Dec 7, 2017

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