{"id":35025400,"url":"https://github.com/openmm/openmm-cookbook","last_synced_at":"2026-02-09T18:09:16.750Z","repository":{"id":39989795,"uuid":"399722715","full_name":"openmm/openmm-cookbook","owner":"openmm","description":"The OpenMM Cookbook and Tutorials","archived":false,"fork":false,"pushed_at":"2026-02-07T01:23:55.000Z","size":21788,"stargazers_count":53,"open_issues_count":15,"forks_count":12,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-02-07T12:59:23.312Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openmm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-08-25T07:04:23.000Z","updated_at":"2026-02-07T01:21:10.000Z","dependencies_parsed_at":"2023-12-28T22:30:05.867Z","dependency_job_id":"e2bfdbd7-e495-405e-bd64-5ec3a1d58c12","html_url":"https://github.com/openmm/openmm-cookbook","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/openmm/openmm-cookbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmm%2Fopenmm-cookbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmm%2Fopenmm-cookbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmm%2Fopenmm-cookbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmm%2Fopenmm-cookbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openmm","download_url":"https://codeload.github.com/openmm/openmm-cookbook/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openmm%2Fopenmm-cookbook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29274800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T17:15:22.002Z","status":"ssl_error","status_checked_at":"2026-02-09T17:14:42.395Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2025-12-27T06:20:32.779Z","updated_at":"2026-02-09T18:09:16.744Z","avatar_url":"https://github.com/openmm.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# openmm-cookbook\n\nThis repo is home to the OpenMM Cookbook and the OpenMM Tutorials.\n\nThe latest release can be viewed here: https://openmm.github.io/openmm-cookbook\n\nThe main branch of this repo can be viewed on the development version: https://openmm.github.io/openmm-cookbook/dev/\n\n## Adding a notebook\n\nTo add a new cookbook, add the ipynb notebook to the `notebooks/cookbook` folder and add a link to it in `cookbook.rst`. To add a new tutorial, add the ipynb notebook to the `notebooks/tutorials` folder and add a link to it in `tutorials.rst`.\n\nLinks to download the notebook, view it in GitHub, or open it in Google Colab are added to the rendered notebook on the website automatically. Any files required by the notebook should be placed in the same folder as the notebook: they are required by both the testing apparatus and Google Colab.\n\n\"Open in Google Colab\" links to a copy of the notebook that is constructed when the documentation is built. This copy has a cell injected that allows the notebook's dependencies to be installed automatically. By default, each notebook will install the PyPI packages specified in the `cookbook_default_pypi_deps` variable in `conf.py`, and then download all the files in the notebook's folder into the notebook's execution environment. This can be configured on a per-notebook basis by adding the `pypi_dependencies` or `required_files` metadata entries to the notebook.\n\nNotebook thumbnails can be configured in several ways, as described in the [nbsphinx documentation](https://nbsphinx.readthedocs.io/).\n\n\n## Building locally\n\nFirst clone this repo, then create a conda environment using [environment.yml](environment.yml).\nThe cookbook can then be built using\n```\nmake html\n```\nThe created html will be in the `build/html` directory and can be viewed by opening `build/html/index.html` in a browser.\n\n## Releases\n\nThe cookbook's main branch is the development channel; it is rendered as `https://openmm.github.io/openmm-cookbook/dev/`. Anytime the main branch is updated, the rendered cookbook will be updated.\n\nWhen a release is cut, the current working state of the cookbook will be preserved as `https://openmm.github.io/openmm-cookbook/refs/tags/${release}/index.html`, where `${release}` is the release tag, e.g., `https://openmm.github.io/openmm-cookbook/refs/tags/v0.1/index.html`.\n\nThe latest version of the cookbook will point to the most recent release `https://openmm.github.io/openmm-cookbook/latest/`\n\n## CI\n\nContinuous integration is run on the main branch of the cookbook. Just the notebooks in `notebooks/cookbook` are run through the CI, but tutorials are not (due to long compute time). There are two workflows: [Main](.github/workflows/ci-main.yml) will test that the notebooks run with the latest release of OpenMM, and [Nightly](.github/workflows/ci-nightly.yml) will test that the notebooks run with the development version of OpenMM.\n\n## Pull Requests\n\nWhen a PR is triggered, the cookbook will be rendered as `https://openmm.github.io/openmm-cookbook/PR#/`, where PR# is the pull request number: e.g., [PR16](https://openmm.github.io/openmm-cookbook/PR16/index.html). **Note** that due to GitHub actions permissions, the *Deploy to GitHub Pages* step in the [gh-pages workflow](.github/workflows/gh-pages.yml) will only work correctly if the PR comes from a branch *within* `https://github.com/openmm/openmm-cookbook`, and it will not work when the PR comes from a personal fork.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmm%2Fopenmm-cookbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenmm%2Fopenmm-cookbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenmm%2Fopenmm-cookbook/lists"}