{"id":13698113,"url":"https://github.com/mir-group/nequip","last_synced_at":"2026-01-12T08:33:28.923Z","repository":{"id":37259666,"uuid":"348154786","full_name":"mir-group/nequip","owner":"mir-group","description":"NequIP is a code for building E(3)-equivariant interatomic potentials","archived":false,"fork":false,"pushed_at":"2025-12-01T14:06:51.000Z","size":4505,"stargazers_count":826,"open_issues_count":8,"forks_count":185,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-12-02T05:14:23.278Z","etag":null,"topics":["atomistic-simulations","computational-chemistry","deep-learning","drug-discovery","force-fields","interatomic-potentials","machine-learning","materials-science","molecular-dynamics","pytorch"],"latest_commit_sha":null,"homepage":"https://arxiv.org/abs/2504.16068","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mir-group.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.bib","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-03-15T23:44:39.000Z","updated_at":"2025-12-01T02:54:25.000Z","dependencies_parsed_at":"2023-12-12T23:30:04.619Z","dependency_job_id":"f53ff21e-7a00-4548-9182-6e17ed2f3a3b","html_url":"https://github.com/mir-group/nequip","commit_stats":{"total_commits":1339,"total_committers":8,"mean_commits":167.375,"dds":"0.39283047050037345","last_synced_commit":"c56f48fcc9b4018a84e1ed28f762fadd5bc763f1"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/mir-group/nequip","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mir-group%2Fnequip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mir-group%2Fnequip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mir-group%2Fnequip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mir-group%2Fnequip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mir-group","download_url":"https://codeload.github.com/mir-group/nequip/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mir-group%2Fnequip/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28337598,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"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":["atomistic-simulations","computational-chemistry","deep-learning","drug-discovery","force-fields","interatomic-potentials","machine-learning","materials-science","molecular-dynamics","pytorch"],"created_at":"2024-08-02T19:00:40.199Z","updated_at":"2026-01-12T08:33:28.918Z","avatar_url":"https://github.com/mir-group.png","language":"Python","funding_links":[],"categories":["🔬 Domain-Specific Applications","Software","Interatomic Potentials (ML-IAP)","🛠️ Software Ecosystem"],"sub_categories":["⚛ Chemistry \u0026 Materials","🧪 Codes, Data, and Reproducibility"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./logo.png\" width=\"50%\" title=\"NequIP\" alt=\"NequIP\"/\u003e\n\u003c/p\u003e\n\n\u003cbr/\u003e\n\n[![Documentation Status](https://readthedocs.org/projects/nequip/badge/?version=latest)](https://nequip.readthedocs.io/en/latest/?badge=latest)  [![PyPI version](https://img.shields.io/pypi/v/nequip.svg)](https://pypi.python.org/pypi/nequip/)  [![DOI](https://zenodo.org/badge/348154786.svg)](https://doi.org/10.5281/zenodo.18200066)\n\n\n\n# NequIP\n\nNequIP is an open-source code for building E(3)-equivariant interatomic potentials.\n\n - [Installation and usage](#installation-and-usage)\n - [Tutorial](#tutorial)\n - [Pre-trained models](#pre-trained-models)\n - [Highlighted Features](#highlighted-features)\n - [Extension Packages](#extension-packages)\n - [References \u0026 citing](#references--citing)\n - [Authors](#authors)\n - [Community, contact, questions, and contributing](#community-contact-questions-and-contributing)\n\n\u003e [!IMPORTANT]\n\u003e A [major backwards-incompatible update](./docs/guide/upgrading.md) to the `nequip` package was released on April 23rd 2025 as version v0.7.0. The previous version v0.6.2 can still be found for use with existing config files in the GitHub Releases and on PyPI.\n\n## Installation and usage\n\nInstallation instructions and user guides can be found in our [docs](https://nequip.readthedocs.io/en/latest/).\n\n## Tutorial\n\nThe best way to learn how to use NequIP is through the [tutorial notebook](https://colab.research.google.com/github/mir-group/nequip-tutorial/blob/main/NequIP_Tutorial.ipynb). This will run entirely on Google Colab's cloud virtual machine; you do not need to install or run anything locally.\n\n## Pre-trained models\n\nPre-trained models can be found at [nequip.net](https://www.nequip.net/).\n\n## Highlighted Features\n\nThe following are some notable features, with quick links for more details:\n\n- [Compiled training](https://nequip.readthedocs.io/en/latest/guide/accelerations/pt2_compilation.html) and [compiled inference](https://nequip.readthedocs.io/en/latest/guide/getting-started/workflow.html#compilation)\n- [Multi-GPU training](https://nequip.readthedocs.io/en/latest/guide/accelerations/ddp_training.html)\n- [GPU kernel accelerations](https://nequip.readthedocs.io/en/latest/guide/accelerations/gpu_kernel_modifiers.html) with [OpenEquivariance](https://github.com/PASSIONLab/OpenEquivariance) and [CuEquivariance](https://github.com/NVIDIA/cuEquivariance) (alpha)\n- [ASE calculator integration](https://nequip.readthedocs.io/en/latest/integrations/ase.html) and [LAMMPS integrations](https://nequip.readthedocs.io/en/latest/integrations/lammps/index.html) through the pair styles in [`pair_nequip_allegro`](https://nequip.readthedocs.io/en/latest/integrations/lammps/pair_styles.html) and our LAMMPS [ML-IAP integration](https://nequip.readthedocs.io/en/latest/integrations/lammps/mliap.html).\n\n## Extension Packages\n\nThe NequIP software framework is designed to be flexible and extensible: you can build custom architectures, implement new training techniques, and develop additional methods on top of it through extension packages.\nIf you're interested in developing your own extension package, please refer to the [extension package docs](https://nequip.readthedocs.io/en/latest/dev/extension_packages.html) and consider [joining our Zulip](https://forms.gle/mEuonVCHdsgTtLXy7) for developer-focused discussions and collaborations.\n\nA notable example of a NequIP framework extension package is the [`allegro`](https://github.com/mir-group/allegro) package that implements the strictly local equivariant interatomic potential architecture, [Allegro](https://www.nature.com/articles/s41467-023-36329-y). More extension packages can be found at https://www.nequip.net/extensions.\n\n## References \u0026 citing\n\n**Any and all use of this software, in whole or in part, should clearly acknowledge and link to this repository.**\n\nIf you use this code in your academic work, please cite:\n\n 1. The [preprint describing the NequIP software framework](https://arxiv.org/abs/2504.16068):\n    \u003e Chuin Wei Tan, Marc L. Descoteaux, Mit Kotak, Gabriel de Miranda Nascimento, Seán R. Kavanagh, Laura Zichi, Menghang Wang, Aadit Saluja, Yizhong R. Hu, Tess Smidt, Anders Johansson, William C. Witt, Boris Kozinsky, Albert Musaelian. \u003cbr/\u003e\n    \u003e \"High-performance training and inference for deep equivariant interatomic potentials.\" \u003cbr/\u003e\n    \u003e https://doi.org/10.48550/arXiv.2504.16068\n\nAnd also consider citing:\n\n 2. The [original NequIP paper](https://www.nature.com/articles/s41467-022-29939-5)\n    \u003e Simon Batzner, Albert Musaelian, Lixin Sun, Mario Geiger, Jonathan P. Mailoa, Mordechai Kornbluth, Nicola Molinari, Tess E. Smidt, and Boris Kozinsky. \u003cbr/\u003e\n    \u003e \"E(3)-equivariant graph neural networks for data-efficient and accurate interatomic potentials.\" \u003cbr/\u003e\n    \u003e Nature Communications 13, no. 1 (2022): 2453\n\n 3. The [computational scaling paper](https://dl.acm.org/doi/abs/10.1145/3581784.3627041) that discusses optimized LAMMPS MD\n    \u003e Albert Musaelian, Anders Johansson, Simon Batzner, and Boris Kozinsky. \u003cbr/\u003e\n    \u003e \"Scaling the leading accuracy of deep equivariant models to biomolecular simulations of realistic size.\" \u003cbr/\u003e\n    \u003e In Proceedings of the International Conference for High Performance Computing, Networking, Storage and Analysis, pp. 1-12. 2023.\n\n 4. The `e3nn` equivariant neural network package used by NequIP, through its [preprint](https://arxiv.org/abs/2207.09453) and/or [code](https://github.com/e3nn/e3nn)\n\n**Extension packages like [Allegro](https://github.com/mir-group/allegro) have their own additional relevant citations.**\n\nBibTeX entries for a number of the relevant papers are provided for convenience in [`CITATION.bib`](./CITATION.bib).\n\n## Authors\n\nPlease see [`AUTHORS.md`](./AUTHORS.md).\n\n## Community, contact, questions, and contributing\n\nIf you find a bug or have a proposal for a feature, please post it in the [Issues](https://github.com/mir-group/nequip/issues).\nIf you have a self-contained question or other discussion topic, try our [GitHub Discussions](https://github.com/mir-group/nequip/discussions).\n\nActive users and interested developers are invited to join us on the NequIP community chat server, which is hosted on the excellent [Zulip](https://zulip.com/) software.\nZulip is organized a little bit differently than chat software like Slack or Discord that you may be familiar with: please review [their introduction](https://zulip.com/help/introduction-to-topics) before posting.\n[Fill out the interest form for the NequIP community here](https://forms.gle/mEuonVCHdsgTtLXy7).\n\nIf you want to contribute to the code, please read [\"Contributing to NequIP\"](docs/dev/contributing.md).\n\nWe can also be reached by email at allegro-nequip@g.harvard.edu.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmir-group%2Fnequip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmir-group%2Fnequip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmir-group%2Fnequip/lists"}