114 releases (15 breaking)

new 0.16.4 Sep 27, 2023
0.15.6 Aug 29, 2023
0.15.4 Jul 31, 2023
0.10.0-rc.6 Feb 8, 2023
0.0.2 Oct 19, 2021

#367 in Development tools

Download history 57/week @ 2023-06-07 19/week @ 2023-06-14 106/week @ 2023-06-21 181/week @ 2023-06-28 189/week @ 2023-07-05 221/week @ 2023-07-12 157/week @ 2023-07-19 299/week @ 2023-07-26 642/week @ 2023-08-02 639/week @ 2023-08-09 329/week @ 2023-08-16 698/week @ 2023-08-23 88/week @ 2023-08-30 297/week @ 2023-09-06 340/week @ 2023-09-13 278/week @ 2023-09-20

1,190 downloads per month


4.5K SLoC


The qcs crate is a high-level interface to Rigetti's Quantum Cloud Services, allowing Rust developers to run Quil programs on Rigetti's QPUs. This crate is a Rust port of pyQuil, though it currently has a much smaller feature set.

For the C-bindings to this library, check out qcs-sdk-c


This crate is documented primarily via rustdoc comments and examples, which are available on docs.rs.


Most development tasks are automated with cargo-make (like make, but you can have dependencies on other Rust tools and a ton of useful tasks are built in). Install cargo-make by doing cargo install cargo-make. Then you can invoke it with either cargo make <task> or makers <task>. Tasks are defined in files called Makefile.toml.

In order to run all checks exactly the same way that CI does, use makers ci-flow from the project root (workspace).


Because this library relies on [ØMQ], cmake is required:

  • macOS [Homebrew] : brew install cmake
  • Windows [Chocolatey]: choco install cmake
  • Debian: apt install cmake

Running Tests

The best way to go about this is via makers or cargo make with no task. This will default to dev-test-flow which formats all code, builds, and tests everything.

Any tests which cannot be run in CI should be run with makers manual. These tests require configured QCS credentials with access to internal functions, as well as a connection to the Rigetti VPN.


makers lint will lint run all static checks.


To build the docs.rs-style docs, run makers docs. You can also do makers serve-docs to launch a local webserver for viewing immediately.


To release this crate, manually run the release workflow in GitHub Actions.


~781K SLoC