{"id":13452320,"url":"https://github.com/hypothesis/h","last_synced_at":"2025-05-13T22:02:59.687Z","repository":{"id":2902691,"uuid":"3910945","full_name":"hypothesis/h","owner":"hypothesis","description":"Annotate with anyone, anywhere.","archived":false,"fork":false,"pushed_at":"2025-04-25T08:20:31.000Z","size":42982,"stargazers_count":3025,"open_issues_count":175,"forks_count":442,"subscribers_count":98,"default_branch":"main","last_synced_at":"2025-04-25T08:35:18.597Z","etag":null,"topics":["annotation","hypothesis","python"],"latest_commit_sha":null,"homepage":"https://hypothes.is/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hypothesis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2012-04-02T19:56:59.000Z","updated_at":"2025-04-24T10:47:08.000Z","dependencies_parsed_at":"2024-01-22T12:25:59.549Z","dependency_job_id":"6089a1e3-cc11-4de8-a7e3-99f1326879b9","html_url":"https://github.com/hypothesis/h","commit_stats":{"total_commits":14010,"total_committers":98,"mean_commits":142.9591836734694,"dds":0.7798001427551748,"last_synced_commit":"710a479289aa757cc24fd19a798e71d178eb1ad1"},"previous_names":[],"tags_count":90,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hypothesis","download_url":"https://codeload.github.com/hypothesis/h/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251339452,"owners_count":21573729,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["annotation","hypothesis","python"],"created_at":"2024-07-31T07:01:20.528Z","updated_at":"2025-04-28T15:35:49.141Z","avatar_url":"https://github.com/hypothesis.png","language":"Python","readme":"\u003ca href=\"https://github.com/hypothesis/h/actions/workflows/ci.yml?query=branch%3Amain\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/hypothesis/h/ci.yml?branch=main\"\u003e\u003c/a\u003e\n\u003ca\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.12-success\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/hypothesis/h/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-BSD--2--Clause-success\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/hypothesis/cookiecutters/tree/main/pyramid-app\"\u003e\u003cimg src=\"https://img.shields.io/badge/cookiecutter-pyramid--app-success\"\u003e\u003c/a\u003e\n\u003ca href=\"https://black.readthedocs.io/en/stable/\"\u003e\u003cimg src=\"https://img.shields.io/badge/code%20style-black-000000\"\u003e\u003c/a\u003e\n\n# h\n\nh is the web app that serves most of the https://hypothes.is/ website, including the web annotations API at https://hypothes.is/api/. The [Hypothesis client](https://github.com/hypothesis/client) is a browser-based annotator that is a client for h's API.\n\n## Community\n\nJoin us on Slack ([request an invite](https://slack.hypothes.is) or [log in once you've created an account](https://hypothesis-open.slack.com/)).\n\nIf you'd like to contribute to the project, you should also [subscribe](mailto:dev+subscribe@list.hypothes.is)\nto the [development mailing list](https://groups.google.com/a/list.hypothes.is/forum/#!forum/dev)\nand read our [Contributor's guide](https://h.readthedocs.io/en/latest/developing/).\nThen consider getting started on one of the issues that are ready for work.\n\nPlease note that this project is released with a [Contributor Code of Conduct](https://github.com/hypothesis/.github/blob/main/CODE_OF_CONDUCT.md).\nBy participating in this project you agree to abide by its terms.\n\n## Setting up Your h Development Environment\n\nFirst you'll need to install:\n\n* [Git](https://git-scm.com/).\n  On Ubuntu: `sudo apt install git`, on macOS: `brew install git`.\n* [GNU Make](https://www.gnu.org/software/make/).\n  This is probably already installed, run `make --version` to check.\n* [pyenv](https://github.com/pyenv/pyenv).\n  Follow the instructions in pyenv's README to install it.\n  The **Homebrew** method works best on macOS.\n  The **Basic GitHub Checkout** method works best on Ubuntu.\n  You _don't_ need to set up pyenv's shell integration (\"shims\"), you can\n  [use pyenv without shims](https://github.com/pyenv/pyenv#using-pyenv-without-shims).\n* [Docker Desktop](https://www.docker.com/products/docker-desktop/).\n  On Ubuntu follow [Install on Ubuntu](https://docs.docker.com/desktop/install/ubuntu/).\n  On macOS follow [Install on Mac](https://docs.docker.com/desktop/install/mac-install/).\n* [Node](https://nodejs.org/) and npm.\n  On Ubuntu: `sudo snap install --classic node`.\n  On macOS: `brew install node`.\n* [Yarn](https://yarnpkg.com/): `sudo npm install -g yarn`.\n\nThen to set up your development environment:\n\n```terminal\ngit clone https://github.com/hypothesis/h.git\ncd h\nmake services\nmake devdata\nmake help\n```\n\nSee the [Contributor's guide](https://h.readthedocs.io/en/latest/developing/) for further instructions on setting up a development environment and contributing to h.\n\n## Changing the Project's Python Version\n\nTo change what version of Python the project uses:\n\n1. Change the Python version in the\n   [cookiecutter.json](.cookiecutter/cookiecutter.json) file. For example:\n\n   ```json\n   \"python_version\": \"3.10.4\",\n   ```\n\n2. Re-run the cookiecutter template:\n\n   ```terminal\n   make template\n   ```\n\n3. Re-compile the `requirements/*.txt` files.\n   This is necessary because the same `requirements/*.in` file can compile to\n   different `requirements/*.txt` files in different versions of Python:\n\n   ```terminal\n   make requirements\n   ```\n\n4. Commit everything to git and send a pull request\n\n## Changing the Project's Python Dependencies\n\n### To Add a New Dependency\n\nAdd the package to the appropriate [`requirements/*.in`](requirements/)\nfile(s) and then run:\n\n```terminal\nmake requirements\n```\n\n### To Remove a Dependency\n\nRemove the package from the appropriate [`requirements/*.in`](requirements)\nfile(s) and then run:\n\n```terminal\nmake requirements\n```\n\n### To Upgrade or Downgrade a Dependency\n\nWe rely on [Dependabot](https://github.com/dependabot) to keep all our\ndependencies up to date by sending automated pull requests to all our repos.\nBut if you need to upgrade or downgrade a package manually you can do that\nlocally.\n\nTo upgrade a package to the latest version in all `requirements/*.txt` files:\n\n```terminal\nmake requirements --always-make args='--upgrade-package \u003cFOO\u003e'\n```\n\nTo upgrade or downgrade a package to a specific version:\n\n```terminal\nmake requirements --always-make args='--upgrade-package \u003cFOO\u003e==\u003cX.Y.Z\u003e'\n```\n\nTo upgrade **all** packages to their latest versions:\n\n```terminal\nmake requirements --always-make args=--upgrade\n```\n","funding_links":[],"categories":["Python","python","[🎓 research](https://github.com/stars/ketsapiwiq/lists/research)"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypothesis%2Fh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypothesis%2Fh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypothesis%2Fh/lists"}