# Install staq with Homebrew

Full-stack quantum processing toolkit. Version 3.5 via Homebrew; verified 2026-07-13.

## Install

```sh
sudo av install brew:staq
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install staq
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:staq
- **Package manager:** Homebrew
- **Version:** 3.5
- **Source summary:** Full-stack quantum processing toolkit
- **Homepage:** <https://iopscience.iop.org/article/10.1088/2058-9565/ab9359/pdf>
- **Repository:** <https://github.com/softwareQinc/staq>
- **Last updated:** 2026-07-13T17:31:48+09:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- staq (alias)
- staq_circ (alias)
- staq_desugarer (alias)
- staq_device_generator (alias)
- staq_grid_synth (alias)
- staq_group_qregs (alias)
- staq_inliner (alias)
- staq_ionq (alias)
- staq_lattice_surgery (alias)
- staq_mapper (alias)
- staq_oracle_synthesizer (alias)
- staq_projectq (alias)
- staq_qasm_synth (alias)
- staq_qsharp (alias)
- staq_quil (alias)
- staq_resource_estimator (alias)
- staq_rotation_optimizer (alias)
- staq_simplifier (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 3.5
## Project history and usage

staq is a C++ quantum-circuit toolkit distributed as both a library and a collection of command-line tools for OpenQASM-centered circuit synthesis, transformation, optimization, mapping, and translation.

### Project history

The project is maintained by softwareQ Inc. Its README describes a modern C++17 library with low external dependencies, usable through binary tools or as a header-only library for parsing and manipulating OpenQASM 2.0 circuits. The linked paper, first posted as an arXiv preprint in December 2019 and later published in Quantum Science and Technology in 2020, frames staq as a full-stack quantum processing toolkit.

staq's design is explicitly source-oriented: the README says it manipulates OpenQASM syntax trees directly, taking inspiration from Clang, rather than lowering immediately to an intermediate representation. That made it useful for source-to-source transformations and translations where preserving the structure of QASM input mattered.

### Adoption history

For package-manager users, staq shows up as a Homebrew formula with many small executables rather than a single monolithic binary. The input package facts list the main `staq` tool alongside specialist tools such as simplifiers, inliners, mappers, resource estimators, and language/library translators.

The project did not become a general-purpose developer utility like a formatter or shell tool; its adoption is concentrated in quantum software workflows, especially scripts and experiments built around OpenQASM.

### How it is used

The official tool-suite wiki documents a Unix-style workflow where OpenQASM source is passed through individual tools using standard input, standard output, and shell pipes. That style encourages users to compose exactly the circuit passes they need.

Common usage includes desugaring, inlining, simplifying, optimizing rotations, mapping circuits to device constraints, estimating resources, and translating OpenQASM into targets such as Quil, ProjectQ, Q#, and Cirq.

### Why package nerds care

staq is interesting to package maintainers because it turns a specialized research compiler into a set of ordinary command-line programs. The package exposes many narrowly scoped binaries, which fits the Unix-pipeline culture better than a large GUI or cloud-only quantum SDK.

Its low-dependency C++17 implementation and MIT license also make it relatively straightforward for a package manager to build and ship compared with quantum stacks that pull in larger runtime ecosystems.

### Timeline

- 2019: arXiv preprint describes staq as a full-stack quantum processing toolkit.
- 2020: Paper published in Quantum Science and Technology.
- 2021: Official wiki page documents the separate command-line tools and pipe-based workflow.
- 2024: README lists version 3.5 dated March 8, 2024.

### Related projects

- staq is tied to OpenQASM 2.0 and interoperates conceptually with quantum toolchains such as Quil, ProjectQ, Q#, and Cirq through its translator tools.
- The README credits EPFL logic-synthesis libraries and notes that the OpenQASM parser was adapted from tweedledum.

### Sources

- <https://arxiv.org/abs/1912.06070>
- <https://github.com/softwareQinc/staq#readme>
- <https://github.com/softwareQinc/staq/wiki/The-staq-tool-suite>
- source_facts.executables
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/staq.yml](https://github.com/mxcl/pkgdb/blob/main/combined/staq.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph