# Tergite
[](https://pypi.python.org/pypi/tergite/) [](https://pypi.python.org/pypi/tergite/) [](https://github.com/tergite/tergite/actions) [](https://pypi.python.org/pypi/tergite/)
The SDK in the [Tergite software stack](https://tergite.github.io/) for connecting to the Swedish quantum computer.
It includes:
- [Qiskit](https://github.com/Qiskit/qiskit) providers
**This project is developed by a core group of collaborators.**
**Chalmers Next Labs AB (CNL) takes on the role of managing and maintaining this project.**
## Version Control
The tergite stack is developed on a separate version control system and mirrored on Github.
If you are reading this on GitHub, then you are looking at a mirror.
## Installation
Install using pip
```shell
pip install tergite
```
## Dependencies
- [Python 3.9, 3.10](https://www.python.org/)
- [Qiskit +v1.0](https://github.com/Qiskit/qiskit)
- [Tergite Frontend](https://github.com/tergite/tergite-frontend)
## Provider Setup
- Ensure you have [Python +3.9](https://www.python.org/) installed.
- Create an account with [QAL 9000](https://www.qal9000.se/) if you haven't already. (Or you can have your own [tergite Frontend](https://github.com/tergite/tergite-frontend) running)
- With the credentials received from Tergite, create and save a provider account by calling `Tergite.use_provider_account(account, save=True)`.
```python
from tergite.qiskit.providers import Tergite
from tergite.qiskit.providers.provider_account import ProviderAccount
TERGITE_API_URL="https://api.qal9000.se" # or the URL to your own tergite MSS
account = ProviderAccount(
service_name="MY_SERVICE_NAME", url="TERGITE_API_URL", token="MY_API_TOKEN"
)
provider = Tergite.use_provider_account(account, save=True)
```
The code above stores your credentials in a configuration file called `tergiterc`, located in `$HOME/.qiskit` folder, `$HOME` being your home directory.
Once saved, you can retrieve this particular account using the `SERVICE_NAME` from anywhere in your code. From the provider, you can retrieve any backend you wish by name.
```python
provider = Tergite.get_provider(service_name="MY_SERVICE_NAME")
# display list of backends
print(provider.backends())
# access the 'Loke' backend
backend = provider.get_backend("Loke")
```
### Create a Throw-away Provider Account
- Alternatively, you can create a provider account that won't be saved. This is useful in things like automated tests. Just call the `Tergite.use_provider_account(account)` without the `save` option.
```python
# the account from before
provider = Tergite.use_provider_account(account)
```
- You can look at the [examples folder](./examples) for more samples.
## Examples and demos
This project has a long history with contributions of many different partners.
All files in the `archive` folder are scripts from live demonstrations, which show the historical progression of the project.
Since research in quantum computing is moving fast, these files are meant to inspire and might not be functional with the source code of this library.
To find out how to use the library, please take a look into the notebooks and scripts inside the `examples` folder.
## ToDo
- [ ] Add docs and doc generation
## Contribution Guidelines
If you would like to contribute to tergite, please have a look at our [contribution guidelines](./CONTRIBUTING.md)
## Authors
This project is a work of [many contributors](https://github.com/tergite/tergite/graphs/contributors).
Special credit goes to the authors of this project as seen in the [CREDITS](./CREDITS.md) file.
## ChangeLog
To view the changelog for each version, have a look at the [CHANGELOG.md](./CHANGELOG.md) file.
## License
[Apache 2.0 License](./LICENSE.txt)
## Acknowledgements
This project was sponsored by:
- [Knut and Alice Wallenberg Foundation](https://kaw.wallenberg.org/en) under the [Wallenberg Center for Quantum Technology (WACQT)](https://www.chalmers.se/en/centres/wacqt/) project at [Chalmers University of Technology](https://www.chalmers.se)
- [Nordic e-Infrastructure Collaboration (NeIC)](https://neic.no) and [NordForsk](https://www.nordforsk.org/sv) under the [NordIQuEst](https://neic.no/nordiquest/) project
- [European Union's Horizon Europe](https://research-and-innovation.ec.europa.eu/funding/funding-opportunities/funding-programmes-and-open-calls/horizon-europe_en) under the [OpenSuperQ](https://cordis.europa.eu/project/id/820363) project
- [European Union's Horizon Europe](https://research-and-innovation.ec.europa.eu/funding/funding-opportunities/funding-programmes-and-open-calls/horizon-europe_en) under the [OpenSuperQPlus](https://opensuperqplus.eu/) project
Raw data
{
"_id": null,
"home_page": "https://github.com/tergite/tergite",
"name": "tergite",
"maintainer": "Chalmers Next Labs AB",
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": "quantum.nextlabs@chalmers.se",
"keywords": "quantum-computer, qiskit, quantum, tergite, sdk",
"author": "Miroslav Dobsicek",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/31/f7/e7b02381437877f166cce4f66e611b2e1a749451dfdb332ae62a1ff26382/tergite-2024.12.1.tar.gz",
"platform": null,
"description": "# Tergite\n\n[](https://pypi.python.org/pypi/tergite/) [](https://pypi.python.org/pypi/tergite/) [](https://github.com/tergite/tergite/actions) [](https://pypi.python.org/pypi/tergite/) \n\nThe SDK in the [Tergite software stack](https://tergite.github.io/) for connecting to the Swedish quantum computer. \n\nIt includes:\n\n- [Qiskit](https://github.com/Qiskit/qiskit) providers\n\n**This project is developed by a core group of collaborators.**\n**Chalmers Next Labs AB (CNL) takes on the role of managing and maintaining this project.**\n\n## Version Control\n\nThe tergite stack is developed on a separate version control system and mirrored on Github.\nIf you are reading this on GitHub, then you are looking at a mirror.\n\n## Installation\n\nInstall using pip\n\n```shell\npip install tergite\n```\n\n## Dependencies\n\n- [Python 3.9, 3.10](https://www.python.org/)\n- [Qiskit +v1.0](https://github.com/Qiskit/qiskit)\n- [Tergite Frontend](https://github.com/tergite/tergite-frontend)\n\n## Provider Setup\n\n- Ensure you have [Python +3.9](https://www.python.org/) installed.\n\n- Create an account with [QAL 9000](https://www.qal9000.se/) if you haven't already. (Or you can have your own [tergite Frontend](https://github.com/tergite/tergite-frontend) running)\n\n- With the credentials received from Tergite, create and save a provider account by calling `Tergite.use_provider_account(account, save=True)`.\n\n```python\nfrom tergite.qiskit.providers import Tergite\nfrom tergite.qiskit.providers.provider_account import ProviderAccount\n\nTERGITE_API_URL=\"https://api.qal9000.se\" # or the URL to your own tergite MSS\n\naccount = ProviderAccount(\n service_name=\"MY_SERVICE_NAME\", url=\"TERGITE_API_URL\", token=\"MY_API_TOKEN\"\n)\nprovider = Tergite.use_provider_account(account, save=True)\n```\n\nThe code above stores your credentials in a configuration file called `tergiterc`, located in `$HOME/.qiskit` folder, `$HOME` being your home directory.\n\nOnce saved, you can retrieve this particular account using the `SERVICE_NAME` from anywhere in your code. From the provider, you can retrieve any backend you wish by name.\n\n```python\nprovider = Tergite.get_provider(service_name=\"MY_SERVICE_NAME\")\n\n# display list of backends\nprint(provider.backends())\n\n# access the 'Loke' backend\nbackend = provider.get_backend(\"Loke\")\n```\n\n### Create a Throw-away Provider Account\n\n- Alternatively, you can create a provider account that won't be saved. This is useful in things like automated tests. Just call the `Tergite.use_provider_account(account)` without the `save` option.\n\n```python\n# the account from before\nprovider = Tergite.use_provider_account(account)\n```\n\n- You can look at the [examples folder](./examples) for more samples.\n\n## Examples and demos\n\nThis project has a long history with contributions of many different partners. \nAll files in the `archive` folder are scripts from live demonstrations, which show the historical progression of the project.\nSince research in quantum computing is moving fast, these files are meant to inspire and might not be functional with the source code of this library.\n\nTo find out how to use the library, please take a look into the notebooks and scripts inside the `examples` folder.\n\n## ToDo\n\n- [ ] Add docs and doc generation\n\n## Contribution Guidelines\n\nIf you would like to contribute to tergite, please have a look at our [contribution guidelines](./CONTRIBUTING.md)\n\n## Authors\n\nThis project is a work of [many contributors](https://github.com/tergite/tergite/graphs/contributors).\n\nSpecial credit goes to the authors of this project as seen in the [CREDITS](./CREDITS.md) file.\n\n## ChangeLog\n\nTo view the changelog for each version, have a look at the [CHANGELOG.md](./CHANGELOG.md) file.\n\n## License\n\n[Apache 2.0 License](./LICENSE.txt)\n\n## Acknowledgements\n\nThis project was sponsored by:\n\n- [Knut and Alice Wallenberg Foundation](https://kaw.wallenberg.org/en) under the [Wallenberg Center for Quantum Technology (WACQT)](https://www.chalmers.se/en/centres/wacqt/) project at [Chalmers University of Technology](https://www.chalmers.se)\n- [Nordic e-Infrastructure Collaboration (NeIC)](https://neic.no) and [NordForsk](https://www.nordforsk.org/sv) under the [NordIQuEst](https://neic.no/nordiquest/) project\n- [European Union's Horizon Europe](https://research-and-innovation.ec.europa.eu/funding/funding-opportunities/funding-programmes-and-open-calls/horizon-europe_en) under the [OpenSuperQ](https://cordis.europa.eu/project/id/820363) project\n- [European Union's Horizon Europe](https://research-and-innovation.ec.europa.eu/funding/funding-opportunities/funding-programmes-and-open-calls/horizon-europe_en) under the [OpenSuperQPlus](https://opensuperqplus.eu/) project\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "The SDK in the Tergite software stack for connecting to the Swedish quantum computer",
"version": "2024.12.1",
"project_urls": {
"Homepage": "https://github.com/tergite/tergite",
"Repository": "https://github.com/tergite/tergite"
},
"split_keywords": [
"quantum-computer",
" qiskit",
" quantum",
" tergite",
" sdk"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a325edad8c9d7450b991aa44d9bd1290d6b46bbeaee0076fe4d0ebfe57e32882",
"md5": "9a8b6ef0e11ab44dc8c0b41b21e8794d",
"sha256": "b8b3096eff2ca3bcf27e07f82552418e912c56a8261e10ac35aca041bcae634c"
},
"downloads": -1,
"filename": "tergite-2024.12.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9a8b6ef0e11ab44dc8c0b41b21e8794d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 80206,
"upload_time": "2024-12-18T18:35:40",
"upload_time_iso_8601": "2024-12-18T18:35:40.742191Z",
"url": "https://files.pythonhosted.org/packages/a3/25/edad8c9d7450b991aa44d9bd1290d6b46bbeaee0076fe4d0ebfe57e32882/tergite-2024.12.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "31f7e7b02381437877f166cce4f66e611b2e1a749451dfdb332ae62a1ff26382",
"md5": "3c2514151fe6001f2956978ad32cd3d5",
"sha256": "73bb838010fa3a3a86fe533d576d1cd0fe2fda965783eebad27ebc9e6762516a"
},
"downloads": -1,
"filename": "tergite-2024.12.1.tar.gz",
"has_sig": false,
"md5_digest": "3c2514151fe6001f2956978ad32cd3d5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 58751,
"upload_time": "2024-12-18T18:35:43",
"upload_time_iso_8601": "2024-12-18T18:35:43.252153Z",
"url": "https://files.pythonhosted.org/packages/31/f7/e7b02381437877f166cce4f66e611b2e1a749451dfdb332ae62a1ff26382/tergite-2024.12.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-18 18:35:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tergite",
"github_project": "tergite",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tergite"
}
JSON
