One webpage for every book ever published!
Switch branches/tags
594/hotfix/my-turn-to-borrow 596/hotfix/exporting-lists 678/feature/star-ratings 731/hotfix/olid-writeback-to-ia 734/refactor/reading-log-cleanup 740/feature/public-reading-log 740/hotfix/reading-log-notifications 763/refactor/standardized-banner 799/feature/fundraising-banner 805/feature/v1-work-merge-workflow 844/hotfix/slow-work-pages-availability Num170R-move_buy_section dev docker feat/mobile feature/add-survey feature/author-edit-crosslink-remote-ids feature/author-experiment feature/beta feature/borrow-as-ia feature/edition-page-related-carousel feature/editions-works-availability-v2 feature/endpoint-documentation feature/fix-imagecount feature/ia-auth-only feature/list-search feature/loans-carousel feature/net-neutrality feature/survey feature/track-star-ratings feature/waitlist-button footer hornc-patch-1 hotfix/account-waitlist hotfix/analytics hotfix/book-availability hotfix/books-we-love-english-only hotfix/borrow-check hotfix/borrow-redirects hotfix/borrow-regression-tests hotfix/bug-fixes-and-tweaks hotfix/carousel-repair hotfix/double-submit hotfix/fix-waitlist-bug hotfix/git-rev-hash hotfix/homepage-none-len-bug hotfix/ia-auth-messaging hotfix/importbot hotfix/io-xauth-borrow-flow hotfix/lending hotfix/loans-show-waitlist hotfix/openlibraries hotfix/reallow-ol-username-login hotfix/revert-bridge hotfix/rm-net-neutrality-widget hotfix/rm-ol-reset-password hotfix/s3-fallback-to-userpass hotfix/use-email-banner hotfix/user-email-banner-fix-redirect hotfix/user-settings hotfix/waitinglist-carousel hotfix/waitlist-num hotfix/workless-editions-fix hotfix/08-04-downtime html5cat-css-add-sass-support i18n/french i18n/greek ia-auth-only live-borrow-status master production razzius-master refactor/availability refactor/beta refactor/carousels refactor/cleanup refactor/enhanced-work refactor/make-ol-serious-again refactor/merge-read-borrow-databar refactor/mobile-footer refactor/mobile-home refactor/move-work-editions-standalone refactor/pep8 refactor/realtime-search-accuracy refactor/remove-unused-code refactor/search-readd-booksearch revert-411-refactor/ia-ol-auth revert-913-master updating-readme webpy-0.3 whatisgalen-698/feature/book-widget wldb
Nothing to show
Clone or download
Pull request Compare This branch is 885 commits behind internetarchive:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Open Library

Build Status Join the chat at

Open Library is an open, editable library catalog, building towards a web page for every book ever published.

Table of Contents


Open Library is an effort started in 2006 to create "one web page for every book ever published". It provides access to many public domain and out-of-print books, which can be read online.


First you need to have installed Virtualbox and Vagrant.

Next, fork the OpenLibrary repo to your own Github account and clone your forked repo to your local machine:

git clone

Enter the project directory and provision + launch the dev virtual machine instance using vagrant:

cd openlibrary
vagrant up

You can now view your running instance by loading http://localhost:8080 in a web browser.

You can turn off the virtual machine from the host machine using:

vagrant halt

To administrate and ssh into the vagrant dev virtual machine, type:

vagrant ssh

Remember that, thanks to vagrant and virtual box, your local folder openlibrary (where you ran vagrant up) contains exactly the same files as /openlibrary in the dev virtual machine (the one that you login to via vagrant ssh).


If running in Vagrant, but services don't seem to have been properly started -- e.g. the site works but you can't login with the default credentials -- try running vagrant up --provision.

Developer's Guide

For instructions on administrating your Open Library instance and build instructions for developers, refer the Developer's Quickstart Guide.

You can also find more information regarding Developer Documentation for Open Library in the Open Library Wiki

Code Organization

  • openlibrary/core - core openlibrary functionality, imported and used by www
  • openlibrary/plugins - other models, controllers, and view helpers
  • openlibrary/views - views for rendering web pages
  • openlibrary/templates - all the templates used in the website
  • openlibrary/macros - macros are like templates, but can be called from wikitext


The Frontend

The Backend

OpenLibrary is developed on top of the Infogami wiki system, which is itself built on top of the Python web framework and the Infobase database framework.

Once you've read the overview of OpenLibrary Backend technologies, it's highly encouraged you read the developer primer which explains how to use Infogami (and its database, Infobase):

The Service Architecture

Running tests

Open Library tests can be run using pytest (py.test). Kindly look up on our Testing Document for more details

Inside vagrant, go to the application base directory:

cd /openlibrary
make test

Integration Tests

Integration tests use the Splinter webdriver with Google Chrome. For instructions on installation requirements and running integration tests, see Integration Tests README


Check out our contributor's guide to learn how you can contribute!


All source code published here is available under the terms of the GNU Affero General Public License, version 3. Please see for more information.