Skip to content
Open ONI (Open Online Newspaper Initiative) Django web app
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
conf Make conf/schema.xml a symlink to docker schema Aug 1, 2017
core Merge pull request #403 from open-oni/filter_titles May 2, 2019
data the batches directory needs to be there for tests Sep 8, 2012
docker creates / destroys test db each run Aug 28, 2018
example template cleanups/renameing Jul 14, 2016
scripts Remove "openoni" namespace Jul 19, 2016
static want to avoid crawlers sucking down the largish ocr dump files Sep 17, 2012
themes fix custom theme readme information Oct 26, 2016
.gitignore Add support for docker-compose.override.yml Oct 25, 2017
LICENSE Copies in the license from the open-oni/models project Jul 14, 2016 Update Feb 8, 2019
docker-compose.override.yml-example Unpin RAIS Jan 26, 2018
docker-compose.yml Unpin RAIS Jan 26, 2018
requirements.lock Ensure pip installs known-safe dependencies Jan 24, 2018
requirements.pip Revert "Freeze all dependencies" Jan 24, 2018
test-compose.yml Add test environment Aug 24, 2017


openoni is a community maintained project developed from chronam, the Django application that the Library of Congress uses to make its Chronicling America website. The Chronicling America website makes millions of pages of historic American newspapers that have been digitized by the National Digital Newspaper Program (NDNP) browsable and searchable on the Web. A little bit of background is needed to understand why this software is being made available.

NDNP is actually a partnership between the Library of Congress, the National Endowment for the Humanities (NEH), and cultural heritage organizations (awardees) across the United States who have applied for grants to help digitize newspapers in their state. Awardees digitize newspaper microfilm according to a set of specifications and then ship the data back to the Library of Congress where it is loaded into Chronicling America.

Awardee institutions are able to use this data however they want, including creating their own websites that highlight their newspaper content in the local context of their own collections. The idea of making openoni available here on Github is to provide a technical option to these awardees, or other interested parties who want to make their own websites of NDNP newspaper content available. openoni provides a core set of functionality for loading, modeling and indexing NDNP data, while allowing you to customize the look and feel of the website to suit the needs of your organization.

The NDNP data is in the Public Domain and is itself [available] ( on the Web for anyone to use. The hope is that the openoni software can be useful for others who want to work with and/or publish the content.


Open-ONI releases can be found on our releases page. Open-ONI is alpha software and documentation is incomplete at this time.


Please note: for development, look at the docker setup.

Production install instructions are still a work in progress. We reccomend installing from the latest release to evaluate the software. If you are interested in contributing code, please use the dev branch. Please see the contribute page on the wiki for details.


docker-compose -f test-compose.yml -p onitest up test

This will spew a lot of output and you'll have to scroll back a ways to get at test failure information. But it runs a test container setup that ensures your development data cannot possibly be modified.


We have a development slack at Please email kdalziel [at] for an invite.


Licensed under the Apache License, Version 2.0.


Documentation is in progress on the project Wiki.

You can’t perform that action at this time.