<div align="center">
<img src="https://www.netket.org/logo/logo_simple.jpg" alt="logo" width="400"></img>
</div>
# __NetKet__
[](https://github.com/netket/netket/releases)
[](https://anaconda.org/conda-forge/netket)
[](https://scipost.org/SciPostPhysCodeb.7/pdf)
[](https://codecov.io/gh/netket/netket)
[](https://join.slack.com/t/mlquantum/shared_invite/zt-19wibmfdv-LLRI6i43wrLev6oQX0OfOw)
NetKet is an open-source project delivering cutting-edge methods for the study
of many-body quantum systems with artificial neural networks and machine learning techniques.
It is a Python library built on [JAX](https://github.com/google/jax).
- **Homepage:** <https://www.netket.org>
- **Citing:** <https://www.netket.org/cite/>
- **Documentation:** <https://netket.readthedocs.io/en/latest/index.html>
- **Tutorials:** <https://netket.readthedocs.io/en/latest/tutorials/gs-ising.html>
- **Examples:** <https://github.com/netket/netket/tree/master/Examples>
- **Source code:** <https://github.com/netket/netket>
## Installation and Usage
NetKet runs on MacOS and Linux. We recommend to install NetKet using `pip`, but it can also be installed with `conda`.
It is often necessary to first update `pip` to a recent release (`>=20.3`) in order for upper compatibility bounds to be considered and avoid a broken installation.
For instructions on how to install the latest stable/beta release of NetKet see the [Get Started](https://www.netket.org/get_started/) page of our website or run the following command (Apple M1 users, follow that link for more instructions):
```sh
pip install --upgrade pip
pip install --upgrade netket
```
If you wish to install the current development version of NetKet, which is the master branch of this GitHub repository, together with the additional dependencies, you can run the following command:
```sh
pip install --upgrade pip
pip install 'git+https://github.com/netket/netket.git#egg=netket[all]'
```
To speed-up NetKet-computations, even on a single machine, you
can install the MPI-related dependencies by using `[mpi]` between square brackets.
```sh
pip install --upgrade pip
pip install --upgrade "netket[mpi]"
```
We recommend to install NetKet with all it's extra dependencies, which are documented below.
However, if you do not have a working MPI compiler in your PATH this installation will most likely fail because
it will attempt to install `mpi4py`, which enables MPI support in netket.
The latest release of NetKet is always available on PyPi and can be installed with `pip`.
NetKet is also available on conda-forge, however the version available through `conda install`
can be slightly out of date compared to PyPi.
To check what is the latest version released on both distributions you can inspect the badges at the top of this readme.
### Extra dependencies
When installing `netket` with pip, you can pass the following extra variants as square brakets. You can install several of them by separating them with a comma.
- `"[dev]"`: installs development-related dependencies such as black, pytest and testing dependencies
- `"[mpi]"`: Installs `mpi4py` to enable multi-process parallelism. Requires a working MPI compiler in your path
- `"[extra]"`: Installs `tensorboardx` to enable logging to tensorboard, and openfermion to convert the QubitOperators.
- `"[all]"`: Installs all extra dependencies
### MPI Support
To enable MPI support you must install [mpi4jax](https://github.com/PhilipVinc/mpi4jax). Please note that we advise to install mpi4jax with the same tool (conda or pip) with which you install it's dependency `mpi4py`.
To check whether MPI support is enabled, check the flags
```python
>>> import netket
>>> netket.utils.mpi.available
True
```
## Getting Started
To get started with NetKet, we recommend you give a look at our [tutorials page](https://netket.readthedocs.io/en/latest/tutorials/gs-ising.html), by running them on your computer or on [Google Colaboratory](https://colab.research.google.com).
There are also many example scripts that you can download, run and edit that showcase some use-cases of NetKet, although they are not commented.
If you want to get in touch with us, feel free to open an issue or a discussion here on GitHub, or to join the MLQuantum slack group where several people involved with NetKet hang out. To join the slack channel just accept [this invitation](https://join.slack.com/t/mlquantum/shared_invite/zt-19wibmfdv-LLRI6i43wrLev6oQX0OfOw)
## License
[Apache License 2.0](https://github.com/netket/netket/blob/master/LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "NetKet",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "Jax, Machine Learning, Monte Carlo, Neural Networks, Neural Quantum States, Quantum",
"author": "Giuseppe Carleo, Filippo Vicentini, The NetKet authors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/2c/1b/f05dd3410caaa5b3fddaae65a9bb48981e86724574c81611bd45e3d2a287/netket-3.15.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n<img src=\"https://www.netket.org/logo/logo_simple.jpg\" alt=\"logo\" width=\"400\"></img>\n</div>\n\n# __NetKet__\n\n[](https://github.com/netket/netket/releases)\n[](https://anaconda.org/conda-forge/netket)\n[](https://scipost.org/SciPostPhysCodeb.7/pdf)\n[](https://codecov.io/gh/netket/netket)\n[](https://join.slack.com/t/mlquantum/shared_invite/zt-19wibmfdv-LLRI6i43wrLev6oQX0OfOw)\n\nNetKet is an open-source project delivering cutting-edge methods for the study\nof many-body quantum systems with artificial neural networks and machine learning techniques.\nIt is a Python library built on [JAX](https://github.com/google/jax).\n\n- **Homepage:** <https://www.netket.org>\n- **Citing:** <https://www.netket.org/cite/>\n- **Documentation:** <https://netket.readthedocs.io/en/latest/index.html>\n- **Tutorials:** <https://netket.readthedocs.io/en/latest/tutorials/gs-ising.html>\n- **Examples:** <https://github.com/netket/netket/tree/master/Examples>\n- **Source code:** <https://github.com/netket/netket>\n\n## Installation and Usage\n\nNetKet runs on MacOS and Linux. We recommend to install NetKet using `pip`, but it can also be installed with `conda`.\nIt is often necessary to first update `pip` to a recent release (`>=20.3`) in order for upper compatibility bounds to be considered and avoid a broken installation.\nFor instructions on how to install the latest stable/beta release of NetKet see the [Get Started](https://www.netket.org/get_started/) page of our website or run the following command (Apple M1 users, follow that link for more instructions):\n\n```sh\npip install --upgrade pip\npip install --upgrade netket\n```\n\nIf you wish to install the current development version of NetKet, which is the master branch of this GitHub repository, together with the additional dependencies, you can run the following command:\n\n```sh\npip install --upgrade pip\npip install 'git+https://github.com/netket/netket.git#egg=netket[all]'\n```\n\nTo speed-up NetKet-computations, even on a single machine, you\ncan install the MPI-related dependencies by using `[mpi]` between square brackets.\n\n```sh\npip install --upgrade pip\npip install --upgrade \"netket[mpi]\"\n```\n\nWe recommend to install NetKet with all it's extra dependencies, which are documented below.\nHowever, if you do not have a working MPI compiler in your PATH this installation will most likely fail because\nit will attempt to install `mpi4py`, which enables MPI support in netket.\n\nThe latest release of NetKet is always available on PyPi and can be installed with `pip`.\nNetKet is also available on conda-forge, however the version available through `conda install`\ncan be slightly out of date compared to PyPi.\nTo check what is the latest version released on both distributions you can inspect the badges at the top of this readme.\n\n### Extra dependencies\nWhen installing `netket` with pip, you can pass the following extra variants as square brakets. You can install several of them by separating them with a comma.\n - `\"[dev]\"`: installs development-related dependencies such as black, pytest and testing dependencies\n - `\"[mpi]\"`: Installs `mpi4py` to enable multi-process parallelism. Requires a working MPI compiler in your path\n - `\"[extra]\"`: Installs `tensorboardx` to enable logging to tensorboard, and openfermion to convert the QubitOperators.\n - `\"[all]\"`: Installs all extra dependencies\n\n### MPI Support\nTo enable MPI support you must install [mpi4jax](https://github.com/PhilipVinc/mpi4jax). Please note that we advise to install mpi4jax with the same tool (conda or pip) with which you install it's dependency `mpi4py`.\n\nTo check whether MPI support is enabled, check the flags\n```python\n>>> import netket\n>>> netket.utils.mpi.available\nTrue\n```\n\n## Getting Started\n\nTo get started with NetKet, we recommend you give a look at our [tutorials page](https://netket.readthedocs.io/en/latest/tutorials/gs-ising.html), by running them on your computer or on [Google Colaboratory](https://colab.research.google.com).\nThere are also many example scripts that you can download, run and edit that showcase some use-cases of NetKet, although they are not commented.\n\nIf you want to get in touch with us, feel free to open an issue or a discussion here on GitHub, or to join the MLQuantum slack group where several people involved with NetKet hang out. To join the slack channel just accept [this invitation](https://join.slack.com/t/mlquantum/shared_invite/zt-19wibmfdv-LLRI6i43wrLev6oQX0OfOw)\n\n## License\n\n[Apache License 2.0](https://github.com/netket/netket/blob/master/LICENSE)\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Netket : Machine Learning toolbox for many-body quantum systems.",
"version": "3.15.1",
"project_urls": {
"changelog": "https://netket.readthedocs.io/en/latest/docs/changelog.html",
"documentation": "https://netket.readthedocs.io/en/latest/#",
"homepage": "https://www.netket.org",
"repository": "https://github.com/netket/netket"
},
"split_keywords": [
"jax",
" machine learning",
" monte carlo",
" neural networks",
" neural quantum states",
" quantum"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dc2500149919033a0054a6dec96a56504eeed2dce7688332d92b47873c7caee8",
"md5": "8ef0ba442aecb5581b0a3a0ec6698b52",
"sha256": "c3eb09eb0ed9e978be2f7843797b866eb6387477ca3f7fc43bf91064f7cd855e"
},
"downloads": -1,
"filename": "netket-3.15.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8ef0ba442aecb5581b0a3a0ec6698b52",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 688525,
"upload_time": "2024-12-05T21:13:09",
"upload_time_iso_8601": "2024-12-05T21:13:09.086893Z",
"url": "https://files.pythonhosted.org/packages/dc/25/00149919033a0054a6dec96a56504eeed2dce7688332d92b47873c7caee8/netket-3.15.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2c1bf05dd3410caaa5b3fddaae65a9bb48981e86724574c81611bd45e3d2a287",
"md5": "73cdc2a2e1d77e8583ebcc7b7cffc1a9",
"sha256": "94076cb9d135efb4980c361be43aef06ef36d6ab8709faa183e662a7cafbf625"
},
"downloads": -1,
"filename": "netket-3.15.1.tar.gz",
"has_sig": false,
"md5_digest": "73cdc2a2e1d77e8583ebcc7b7cffc1a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 426453,
"upload_time": "2024-12-05T21:13:10",
"upload_time_iso_8601": "2024-12-05T21:13:10.857979Z",
"url": "https://files.pythonhosted.org/packages/2c/1b/f05dd3410caaa5b3fddaae65a9bb48981e86724574c81611bd45e3d2a287/netket-3.15.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-05 21:13:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "netket",
"github_project": "netket",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "netket"
}
JSON
