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

A Postgres-backed ContentsManager for IPython/Jupyter.

Project Description

PGContents is a PostgreSQL-backed implementation of IPEP 27. It aims to a be a transparent, drop-in replacement for IPython’s standard filesystem-backed storage system. PGContents’ PostgresContentsManager class can be used to replace all local filesystem storage with database-backed storage, while its PostgresCheckpoints class can be used to replace just IPython’s checkpoint storage. These features are useful when running IPython in environments where you either don’t have access to—or don’t trust the reliability of—the local filesystem of your notebook server.

This repository is under development as part of the Quantopian Research Environment, currently in Open Beta.

Getting Started



  1. Install pgcontents from PyPI via pip install pgcontents[ipy4]. (This will install pgcontents in a manner compatible with a recent Jupyter Notebook version. To install pgcontents with support for the legacy IPython 3.x series, run pip install pgcontents[ipy3]).
  2. Run pgcontents init to configure your database. You will be prompted for a database URL for pgcontents to use for storage. (Alternatively, you can set the PGCONTENTS_DB_URL environment variable, or pass –db-url on the command line).
  3. Configure IPython/Jupyter to use pgcontents as its storage backend. This can be done from the command line or by modifying your notebook config file. For IPython 3.x on a Unix-like system, your notebok config will be located located at ~/.ipython/profile_default/ For Jupyter Notebook, it will will be located at ~/.jupyter/ See the examples directory for example configuration files.
  4. Enjoy your filesystem-free IPython experience!
Release History

Release History

This version
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
pgcontents-0.5.0.tar.gz (39.7 kB) Copy SHA256 Checksum SHA256 Source Jan 24, 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