Skip to content
Quantum circuits for simulations of quantum chemistry and materials.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
continuous-integration Sync build and dev tool changes in from cirq (#294) Oct 24, 2018
dev_tools [Fixes #331] Sync with cirq changes up to Feb26,2019 (… Feb 27, 2019
examples [Fixes #331] Sync with cirq changes up to Feb26,2019 (… Feb 27, 2019


Alpha Release. OpenFermion is an open source library for obtaining and manipulating representations of fermionic systems (including quantum chemistry) for simulation on quantum computers. Cirq is an open source library for writing, manipulating, and optimizing quantum circuits and running them against quantum computers and simulators. OpenFermion-Cirq extends the functionality of OpenFermion by providing routines and tools for using Cirq to compile and compose circuits for quantum simulation algorithms.

Build Status

Getting started

Installing OpenFermion-Cirq requires pip. Make sure that you are using an up-to-date version of it. Once installation is complete, be sure to take a look at our ipython tutorials and code documentation.


To install the latest PyPI releases as libraries (in user mode):

python -m pip install --user openfermioncirq

Developer install

To install the latest versions of OpenFermion, Cirq and OpenFermion-Cirq (in development mode):

git clone
cd OpenFermion-Cirq
python -m pip install -e .

How to contribute

We'd love to accept your contributions and patches to OpenFermion-Cirq. There are a few small guidelines to follow which you can read about here.

How to cite

When using OpenFermion-Cirq for research projects, please cite:

Jarrod R. McClean, Kevin J. Sung, Ian D. Kivlichan, Yudong Cao, Chengyu Dai, E. Schuyler Fried, Craig Gidney, Brendan Gimby, Pranav Gokhale, Thomas Häner, Tarini Hardikar, Vojtĕch Havlíček, Oscar Higgott, Cupjin Huang, Josh Izaac, Zhang Jiang, Xinle Liu, Sam McArdle, Matthew Neeley, Thomas O'Brien, Bryan O'Gorman, Isil Ozfidan, Maxwell D. Radin, Jhonathan Romero, Nicholas Rubin, Nicolas P. D. Sawaya, Kanav Setia, Sukin Sim, Damian S. Steiger, Mark Steudtner, Qiming Sun, Wei Sun, Daochen Wang, Fang Zhang and Ryan Babbush. OpenFermion: The Electronic Structure Package for Quantum Computers. arXiv:1710.07629. 2017.

We are happy to include future contributors as authors on later releases.

Alpha Disclaimer

OpenFermion-Cirq is currently in alpha. We are still making breaking changes. We will break your code when we make new releases. We recommend that you target a specific version of OpenFermion-Cirq, and periodically bump to the latest release. That way you have control over when a breaking change affects you.

Copyright 2018 The OpenFermion Developers. This is not an official Google product.

You can’t perform that action at this time.