Skip to content
Alternative Django based iPython notebook manager
JavaScript Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This effort is now deprecated. See benjie/ipython for other efforts on sorting, searching, tagging in the notebook interface.

Old documentation appears below.

Alternative Django based iPython notebook manager: saves notebooks to database, and archive old revisions.

To use, following these steps.

1) You need to use a development branch of iPython:

You can install this like

pip install -e git://

or just checkout

git clone git://
cd ipython
git checkout ginkgo
python install

2) Install djnbmgr (this module)

git clone git://
cd django-ipy-nbmgr
python install

3) Configure your Django app to include "djnbmgr" in INSTALLED_APPS, and add djnbmgr.urls to your URLs. E.g.

urlpatterns = patterns('',
    url(r'^djnbmgr/', include('djnbmgr.urls')),

Remember to run

python syncdb djnbmgr

4) In a directory where you want to run iPython notebook server, create a file:

from django.conf import settings
  DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', # or whatever your favorite db is
                             'NAME': '...',
                             'USER': '...',
                             'PASSWORD': '...'
  TIME_ZONE = 'America/New_York',
from djnbmgr.manager import DjangoNotebookManager

5) You can start iPython in that directory like this

PYTHONPATH=. ipython notebook --nbmgr loader --ip --pylab inline --NotebookApp.notebook_manager_class=loader.DjangoNotebookManager

6) Start your Django app. You can visit the admin interface to see notebooks from the admin.

7) Enable javascript view of the notebooks. Create a HTML page that includes djnbmgr JS files. E.g. assuming in your Django setting, static files are in /static/djnbmgr and your djnbmgr URLs are mapped to /djnbmgr

    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
    <meta http-equiv="Content-Language" content="en-us" />
    <!-- CSS -->
    <link href="/static/djnbmgr/css/djnbmgr.css" rel="stylesheet" type="text/css" media="screen" />
    <div id="main">
    <!-- djnbmgr JS -->
    <script src="/static/djnbmgr/js/jquery-1.7.2.min.js" type="text/javascript"></script>
    <script src="/static/djnbmgr/js/handlebars-1.0.0.beta.6.js" type="text/javascript"></script>
    <script src="/static/djnbmgr/js/handlebars-templates.js" type="text/javascript"></script>
    <script src="/static/djnbmgr/js/djnbmgr.js" type="text/javascript"></script>
      jQuery(document).ready(function() {
        window.DjangoNotebookManager(jQuery('#main'),'/djnbmgr/api/','url to your ipython server');

There is an example HTML file in djnbmgr/static/djnbmgr/example_ui.html

8) Load that HTML file in the browser, and off you go. For example, the example_ui.html can be loaded with


Of course the example_ui.html file supplied does not have the correct URL to your ipython server and the base URL for your djnbmgr API.

You can also use iPython notebook server as usual, but your notebooks are stored in the database.

Something went wrong with that request. Please try again.