{"id":13751684,"url":"https://github.com/Qiskit/qiskit-serverless","last_synced_at":"2025-05-09T18:31:58.699Z","repository":{"id":63291718,"uuid":"537159688","full_name":"Qiskit/qiskit-serverless","owner":"Qiskit","description":"A programming model for leveraging quantum and classical resources","archived":false,"fork":false,"pushed_at":"2024-10-29T09:48:25.000Z","size":53183,"stargazers_count":67,"open_issues_count":31,"forks_count":31,"subscribers_count":14,"default_branch":"main","last_synced_at":"2024-10-29T11:49:02.818Z","etag":null,"topics":["cloud","python","qiskit","qiskit-serverless","quantum-computing"],"latest_commit_sha":null,"homepage":"https://qiskit.github.io/qiskit-serverless/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Qiskit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-15T18:33:43.000Z","updated_at":"2024-10-29T09:46:36.000Z","dependencies_parsed_at":"2024-04-09T20:31:04.384Z","dependency_job_id":"a89e9219-ea67-43ac-bca2-8ce6005fd271","html_url":"https://github.com/Qiskit/qiskit-serverless","commit_stats":null,"previous_names":["qiskit-extensions/qiskit-serverless","qiskit-extensions/quantum-serverless","qiskit/qiskit-serverless"],"tags_count":50,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qiskit%2Fqiskit-serverless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qiskit%2Fqiskit-serverless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qiskit%2Fqiskit-serverless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qiskit%2Fqiskit-serverless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Qiskit","download_url":"https://codeload.github.com/Qiskit/qiskit-serverless/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224876976,"owners_count":17384699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cloud","python","qiskit","qiskit-serverless","quantum-computing"],"created_at":"2024-08-03T09:00:52.127Z","updated_at":"2025-05-09T18:31:58.674Z","avatar_url":"https://github.com/Qiskit.png","language":"Python","funding_links":[],"categories":["Extensions"],"sub_categories":[],"readme":"[![Stability](https://img.shields.io/badge/stability-alpha-f4d03f.svg)](https://github.com/Qiskit/qiskit-serverless/releases)\n[![License](https://img.shields.io/github/license/qiskit-community/quantum-prototype-template?label=License)](https://github.com/qiskit-community/quantum-prototype-template/blob/main/LICENSE.txt)\n[![Code style: Black](https://img.shields.io/badge/Code%20style-Black-000.svg)](https://github.com/psf/black)\n[![Python](https://img.shields.io/badge/Python-3.11-informational)](https://www.python.org/)\n[![Qiskit](https://img.shields.io/badge/Qiskit-%E2%89%A5%201.0.0-6133BD)](https://github.com/Qiskit/qiskit)\n\n# Qiskit Serverless\n\nQiskit Serverless is a user-friendly tool that enables you to easily run complex quantum computing tasks.\nWith this software, you can execute Qiskit Functions as long running jobs and distribute them across multiple CPUs, GPUs, and QPUs.\nThis means you can take on more complex quantum-classical programs and run them with ease.\nYou don't have to worry about configuration or scaling up computational resources, as Qiskit Serverless takes care of everything for you.\n\n![diagram](./docs/images/qs_diagram.png)\n\n### Table of Contents\n\n1. [Quickstart](#quickstart)\n   1. [Using Docker](#docker)\n   1. [Using Kubernetes](#kubernetes)\n1. Modules\n   1. [Client](./client)\n   1. [Gateway](./gateway)\n   1. [Charts](./charts)\n1. [How to Give Feedback](#how-to-give-feedback)\n1. [Contribution Guidelines](#contribution-guidelines)\n1. [Deprecation Policy](#deprecation-policy)\n1. [References and Acknowledgements](#references-and-acknowledgements)\n1. [License](#license)\n\n----------------------------------------------------------------------------------------------------\n\n### Quickstart\nThis Quickstart section guides users to easily deploy Qiskit Serverless infrastructure and run a simple example.\n\n#### Docker\nFor user convenience, this section assumes that users will deploy the infrastructure in a local environment using Docker following the next steps.\n\n1. Prepare local Qiskit Serverless infrastructure\n   1. Install Docker\n      You can use any runtime that you prefer to run Docker on your machine: Docker Desktop, podman... If you are using a MacOS with ARM processors we highly recommend to use [Colima](https://github.com/abiosoft/colima) as your container runtime to avoid problems with that architecture.\n\n      This is a project that takes advantage of distributed computing, so it places a high demand on resources. We recommend increasing the assigned resources to these runtimes. In case of Colima for example we typically use:\n      ```shell\n      colima start --cpu 4 --memory 8 --disk 100\n      ```\n   1. Install qiskit-serverless on your local system (we recommend using a [virtual environment](https://docs.python.org/3/library/venv.html)).\n      ```shell\n      pip install qiskit-serverless\n      ```\n   1. Clone the Qiskit Serverless repository\n      ```shell\n      git clone https://github.com/Qiskit/qiskit-serverless.git\n      ```\n   1. Run Qiskit Serverless infrastructure\n      Execute Docker Compose using the following commands.\n      ```shell\n      cd qiskit-serverless/\n      sudo docker compose up\n      ```\n\n      The output should resemble the following.\n      ```\n      ~/qiskit-serverless$ sudo docker compose --profile jupyter up\n      [+] Running 5/0\n       ✔ Network public-qiskit-serverless_safe-tier     Created                                           0.0s\n       ✔ Container ray-head                              Created                                           0.0s\n       ✔ Container public-qiskit-serverless-postgres-1  Created                                           0.0s\n       ✔ Container gateway                               Created                                           0.0s\n       ✔ Container scheduler                             Created                                           0.0s\n      Attaching to gateway, public-qiskit-serverless-postgres-1, ray-head, scheduler\n      ```\n1. Write your first Qiskit Function following our hello-world example in the [tutorial section](https://qiskit.github.io/qiskit-serverless/getting_started/basic/01_running_program.html).\n\n   That's all!\n\n#### Kubernetes\nFor user convenience, this section assumes that users will deploy the infrastructure in a local environment using Kind following the next steps.\n\n1. Prepare local Qiskit Serverless infrastructure\n   1. Install Docker\n      You can use any runtime that you prefer to run Docker on your machine: Docker Desktop, podman... If you are using a MacOS with ARM processors we highly recommend to use [Colima](https://github.com/abiosoft/colima) as your container runtime to avoid problems with that architecture.\n\n      This is a project that takes advantage of distributed computing, so it places a high demand on resources. We recommend increasing the assigned resources to these runtimes. In case of Colima for example we typically use:\n      ```shell\n      colima start --cpu 4 --memory 8 --disk 100\n      ```\n   1. Install Kind\n      To simplify the process to deploy a k8s cluster locally we use [Kind](https://kind.sigs.k8s.io/docs/user/quick-start#installation) as the main tool to create a cluster.\n   1. Install qiskit-serverless on your local system (we recommend using a [virtual environment](https://docs.python.org/3/library/venv.html)).\n      ```shell\n      pip install qiskit-serverless\n      ```\n   1. Clone the Qiskit Serverless repository\n      ```shell\n      git clone https://github.com/Qiskit/qiskit-serverless.git\n      ```\n   1. Run Qiskit Serverless infrastructure\n      Execute the script to setup the cluster\n      ```shell\n      tox -e cluster-deploy\n      ```\n      The creation process can take some minutes.\n1. Write your first Qiskit Function following our hello-world example in the [tutorial section](https://qiskit.github.io/qiskit-serverless/getting_started/basic/01_running_program.html).\n\n   That's all!\n\nFor more detailed examples and explanations refer to the [Guide](https://qiskit.github.io/qiskit-serverless/index.html):\n\n1. [Getting Started](https://qiskit.github.io/qiskit-serverless/getting_started/index.html#)\n1. [Example Qiskit Functions](https://qiskit.github.io/qiskit-serverless/examples/index.html)\n1. [Infrastructure](https://qiskit.github.io/qiskit-serverless/deployment/index.html)\n1. [Migrating from Qiskit Runtime programs](https://qiskit.github.io/qiskit-serverless/migration/index.html)\n\n----------------------------------------------------------------------------------------------------\n\n### How to Give Feedback\n\nWe encourage your feedback! You can share your thoughts with us by:\n- Opening an [issue](https://github.com/Qiskit/qiskit-serverless/issues) in the repository\n\n\n----------------------------------------------------------------------------------------------------\n\n### Contribution Guidelines\n\nFor information on how to contribute to this project, please take a look at our [contribution guidelines](CONTRIBUTING.md).\n\n----------------------------------------------------------------------------------------------------\n\n### Deprecation Policy\n\nThis project is meant to evolve rapidly and, as such, do not follow [Qiskit's deprecation policy](https://github.com/Qiskit/qiskit/blob/main/DEPRECATION.md).  We may occasionally make breaking changes in order to improve the user experience.  When possible, we will keep old interfaces and mark them as deprecated, as long as they can co-exist with the new ones.  Each substantial improvement, breaking change, or deprecation will be documented in release notes.\n\n\n----------------------------------------------------------------------------------------------------\n\n## References and Acknowledgements\n[1] Qiskit \\\n    https://github.com/Qiskit/qiskit\n\n[2] Client for IBM Qiskit Runtime \\\n    https://github.com/Qiskit/qiskit-ibm-runtime\n\n\n----------------------------------------------------------------------------------------------------\n\n### License\n[Apache License 2.0](LICENSE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQiskit%2Fqiskit-serverless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FQiskit%2Fqiskit-serverless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQiskit%2Fqiskit-serverless/lists"}