Hypothesis dev install

These sections tell you how to install Hypothesis in a development environment.

Hypothesis is built from two main codebases:

1. The code for the https://hypothes.is/ website itself, which lives in a Git repo named h. This includes an HTTP API for fetching and saving annotations.
2. The code for the Hypothesis annotation client (the sidebar), which lives in a Git repo named client. The client sends HTTP requests to the web service to fetch and save annotations.

If you just want to work on the https://hypothes.is/ website and API then you can just follow the Website dev install section, your development site will automatically use a built copy of the Hypothesis client from npm.

If you want to work on the Hypothesis client code then you need development installs of both the website/API and the client. First follow Website dev install then Client dev install.

• Website dev install
  • Installing the system dependencies on Ubuntu 14.04
  • Installing the system dependencies on OS X
  • Installing the services
  • Installing the gulp command
  • Getting the h source code from GitHub
  • Creating a Python virtual environment
  • Activating your virtual environment
  • Running h
  • Running h’s tests
  • Debugging h
  • Feature flags
  • Troubleshooting
    • Cannot connect to the Docker daemon
• Client dev install