# Scaleway provider for Qiskit
**Qiskit Scaleway** is a Python package to run quantum circuits on [Scaleway](https://www.scaleway.com/en/) infrastructure, providing access to:
- [AQT](https://www.aqt.eu/) ion-trapped quantum computers
- [IQM](https://meetiqm.com/) superconducting quantum computers
- [Aer](https://github.com/Qiskit/qiskit-aer) state vector and tensor network multi-GPU emulators
- [Qsim](https://github.com/quantumlib/qsim) NISQ emulators
To run circuits over [Quandela](https://www.quandela.com/) backends provided by Scaleway, you must use [Perceval SDK](https://perceval.quandela.net/) through the [Scaleway provider](https://perceval.quandela.net/docs/providers.html).
More info on the [Quantum service web page](https://www.scaleway.com/en/quantum-as-a-service/).
## Installation
We encourage installing Scaleway provider via the pip tool (a Python package manager):
```bash
pip install qiskit-scaleway
```
## Getting started
To instantiate the ScalewayProvider, you need to have an access token and a project_id
```python
from qiskit import QuantumCircuit
from qiskit_scaleway import ScalewayProvider
provider = ScalewayProvider(
project_id="<your-scaleway-project-id>",
secret_key="<your-scaleway-secret-key>",
)
```
Alternatively, the Scaleway Provider can discover your access token from environment variables or from your .env file
```
export QISKIT_SCALEWAY_PROJECT_ID="project_id"
export QISKIT_SCALEWAY_SECRET_KEY="token"
```
Then you can instantiate the provider without any arguments:
```python
from qiskit import QuantumCircuit
from qiskit_scaleway import ScalewayProvider
provider = ScalewayProvider()
```
Now you can have acces to the supported backends:
```python
# List all operational backends
backends = provider.backends(operational=True)
print(backends)
# List all backends with a minimum number of qbits
backends = provider.backends(min_num_qubits=35)
print(backends)
# Retrieve a backend by providing search criteria. The search must have a single match
backend = provider.get_backend("aer_simulation_h100") # Or any gate-based compatible QPU
```
Define a quantum circuit and run it
```python
# Define a quantum circuit that produces a 4-qubit GHZ state.
qc = QuantumCircuit(4)
qc.h(0)
qc.cx(0, 1)
qc.cx(0, 2)
qc.cx(0, 3)
qc.measure_all()
## DO NOT USE TRANSPILATION
## Transpilation is done server side on QaaS service
# Create and send a job to a new QPU's session (or on an existing one)
result = backend.run(qc, method="statevector", shots=1000).result()
if result.success:
print(result.get_counts())
else:
print(result.to_dict()["error"])
```
## Development
This repository is at its early stage and is still in active development. If you are looking for a way to contribute please read [CONTRIBUTING.md](CONTRIBUTING.md).
## Reach us
We love feedback. Feel free to reach us on [Scaleway Slack community](https://slack.scaleway.com/), we are waiting for you on [#opensource](https://scaleway-community.slack.com/app_redirect?channel=opensource)..
## License
[License Apache 2.0](LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "qiskit-scaleway",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12.0",
"maintainer_email": null,
"keywords": null,
"author": "The Scaleway Developers",
"author_email": "vmacheret@scaleway.com",
"download_url": "https://files.pythonhosted.org/packages/6f/0d/afb007e5f8fd02c7edc72753fa7dc7234aab15a65b2ef5e59331bad6267d/qiskit_scaleway-0.2.6.tar.gz",
"platform": null,
"description": "# Scaleway provider for Qiskit\n\n**Qiskit Scaleway** is a Python package to run quantum circuits on [Scaleway](https://www.scaleway.com/en/) infrastructure, providing access to:\n- [AQT](https://www.aqt.eu/) ion-trapped quantum computers\n- [IQM](https://meetiqm.com/) superconducting quantum computers\n- [Aer](https://github.com/Qiskit/qiskit-aer) state vector and tensor network multi-GPU emulators\n- [Qsim](https://github.com/quantumlib/qsim) NISQ emulators\n\nTo run circuits over [Quandela](https://www.quandela.com/) backends provided by Scaleway, you must use [Perceval SDK](https://perceval.quandela.net/) through the [Scaleway provider](https://perceval.quandela.net/docs/providers.html).\n\nMore info on the [Quantum service web page](https://www.scaleway.com/en/quantum-as-a-service/).\n\n## Installation\n\nWe encourage installing Scaleway provider via the pip tool (a Python package manager):\n\n```bash\npip install qiskit-scaleway\n```\n\n## Getting started\n\nTo instantiate the ScalewayProvider, you need to have an access token and a project_id\n\n```python\nfrom qiskit import QuantumCircuit\nfrom qiskit_scaleway import ScalewayProvider\n\nprovider = ScalewayProvider(\n project_id=\"<your-scaleway-project-id>\",\n secret_key=\"<your-scaleway-secret-key>\",\n)\n```\n\nAlternatively, the Scaleway Provider can discover your access token from environment variables or from your .env file\n\n```\nexport QISKIT_SCALEWAY_PROJECT_ID=\"project_id\"\nexport QISKIT_SCALEWAY_SECRET_KEY=\"token\"\n```\n\nThen you can instantiate the provider without any arguments:\n\n```python\nfrom qiskit import QuantumCircuit\nfrom qiskit_scaleway import ScalewayProvider\n\nprovider = ScalewayProvider()\n```\n\nNow you can have acces to the supported backends:\n\n\n```python\n# List all operational backends\nbackends = provider.backends(operational=True)\nprint(backends)\n\n# List all backends with a minimum number of qbits\nbackends = provider.backends(min_num_qubits=35)\nprint(backends)\n\n# Retrieve a backend by providing search criteria. The search must have a single match\nbackend = provider.get_backend(\"aer_simulation_h100\") # Or any gate-based compatible QPU\n```\n\nDefine a quantum circuit and run it\n\n```python\n# Define a quantum circuit that produces a 4-qubit GHZ state.\nqc = QuantumCircuit(4)\nqc.h(0)\nqc.cx(0, 1)\nqc.cx(0, 2)\nqc.cx(0, 3)\nqc.measure_all()\n\n## DO NOT USE TRANSPILATION\n## Transpilation is done server side on QaaS service\n\n# Create and send a job to a new QPU's session (or on an existing one)\nresult = backend.run(qc, method=\"statevector\", shots=1000).result()\n\nif result.success:\n print(result.get_counts())\nelse:\n print(result.to_dict()[\"error\"])\n\n```\n\n## Development\nThis repository is at its early stage and is still in active development. If you are looking for a way to contribute please read [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Reach us\nWe love feedback. Feel free to reach us on [Scaleway Slack community](https://slack.scaleway.com/), we are waiting for you on [#opensource](https://scaleway-community.slack.com/app_redirect?channel=opensource)..\n\n## License\n[License Apache 2.0](LICENSE)\n",
"bugtrack_url": null,
"license": "Apache 2",
"summary": "A Qiskit package to connect to Scaleway Quantum as a Service",
"version": "0.2.6",
"project_urls": {
"Documentation": "https://www.scaleway.com/en/quantum-as-a-service/",
"Source": "https://github.com/scaleway/qiskit-scaleway",
"Tracker": "https://github.com/scaleway/qiskit-scaleway/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0b8877d96efbc40c2b7c6fbdaad6afebf5e0f95d255dd8054d93897c5715b2ed",
"md5": "e27cf1ea1887b727e658282eface9ab1",
"sha256": "2c7dd1aa7aa5f552b06e7b1817d075ff4554df7e1572a6264e8d742a9c0c75f3"
},
"downloads": -1,
"filename": "qiskit_scaleway-0.2.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e27cf1ea1887b727e658282eface9ab1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12.0",
"size": 29427,
"upload_time": "2025-07-30T09:41:35",
"upload_time_iso_8601": "2025-07-30T09:41:35.462383Z",
"url": "https://files.pythonhosted.org/packages/0b/88/77d96efbc40c2b7c6fbdaad6afebf5e0f95d255dd8054d93897c5715b2ed/qiskit_scaleway-0.2.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "6f0dafb007e5f8fd02c7edc72753fa7dc7234aab15a65b2ef5e59331bad6267d",
"md5": "18039426b4134fea79ae7ee9db6d535c",
"sha256": "50436ef788aee187a2c1734e386508393df0b96924f25eaa11acaf762fd24ef8"
},
"downloads": -1,
"filename": "qiskit_scaleway-0.2.6.tar.gz",
"has_sig": false,
"md5_digest": "18039426b4134fea79ae7ee9db6d535c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12.0",
"size": 19242,
"upload_time": "2025-07-30T09:41:36",
"upload_time_iso_8601": "2025-07-30T09:41:36.296954Z",
"url": "https://files.pythonhosted.org/packages/6f/0d/afb007e5f8fd02c7edc72753fa7dc7234aab15a65b2ef5e59331bad6267d/qiskit_scaleway-0.2.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 09:41:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "scaleway",
"github_project": "qiskit-scaleway",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "qiskit",
"specs": [
[
"==",
"1.4.2"
]
]
},
{
"name": "qiskit-aer",
"specs": [
[
"==",
"0.17"
]
]
},
{
"name": "randomname",
"specs": [
[
">=",
"0.2.1"
]
]
},
{
"name": "dataclasses-json",
"specs": [
[
">=",
"0.6.4"
]
]
},
{
"name": "dataclasses",
"specs": [
[
">=",
"0.6"
]
]
},
{
"name": "scaleway-qaas-client",
"specs": [
[
">=",
"0.1.12"
]
]
}
],
"lcname": "qiskit-scaleway"
}