Gate and operation specification for quantum circuits
Switch branches/tags
Nothing to show
Clone or download


Specs, examples and tools for the OpenQASM intermediate representation.

Current version

The latest version is: 2.0.

About this project

On this repository you'll find all the documentation related to OpenQASM and some useful OpenQASM examples.

Language specs

The language documentation is available here.


The examples can be found under the examples folder.

They are OpenQASM files, i.e.:

// Repetition code syndrome measurement
include "";
qreg q[3];
qreg a[2];
creg c[3];
creg syn[2];
gate syndrome d1,d2,d3,a1,a2
  cx d1,a1; cx d2,a1;
  cx d2,a2; cx d3,a2;
x q[0]; // error
barrier q;
syndrome q[0],q[1],q[2],a[0],a[1];
measure a -> syn;
if(syn==1) x q[0];
if(syn==2) x q[2];
if(syn==3) x q[1];
measure q -> c;


The official OpenQASM conformance test suite is included in this repo.

Authors (alphabetical)

Lev S. Bishop, Antonio Córcoles, Andrew W. Cross, Jay M. Gambetta, Jesús Pérez and John A. Smolin.

Anyone who contributes to this project can include their name here.

Citation format

For research papers, we encourage authors to reference.

  • Andrew W. Cross, Lev S. Bishop, John A. Smolin, Jay M. Gambetta "Open Quantum Assembly Language" [arXiv:1707.03429].

Other Qiskit projects


This project is licensed under the Apache License 2.0 - see the [LICENSE] file for details.



If you'd like to help please take a look to our contribution guidelines.