From 0a62e93c0675d2fba766e523b363877d246b9b5a Mon Sep 17 00:00:00 2001 From: mhucka Date: Wed, 17 Jun 2026 17:38:40 +0000 Subject: [PATCH 1/9] Add initial org-level README file --- README.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..c3344a9 --- /dev/null +++ b/README.md @@ -0,0 +1,60 @@ +# Welcome to Google Quantum AI's open-source projects + +Quantum AI and collaborators from all around the world maintain and develop +many open-source software projects on GitHub. We build best-in-class libraries +and utilities to advance applications research and error-correction research +for the future of fault-tolerant quantum computing. + +## Repositories + +Quantum AI's open-source projects are found in repositories under the +Quantumlib organization and elsewhere on GitHub. Our major efforts include the +following: + +* [Cirq](https://github.com/quantumlib/Cirq): A Python framework for + creating, editing, manipulating, and running quantum circuits on hardware + or in simulation. + +* [Qualtran](https://github.com/quantumlib/Qualtran): A library of + blueprinted fault-tolerant algorithms and advanced resource estimation + tools used to cost out physical resource requirements. + +* [OpenFermion](https://github.com/quantumlib/OpenFermion): An open-source + library for compiling and translating problems in chemistry and materials + science into quantum circuits. + +* [Stim](https://github.com/quantumlib/Stim): A high-performance, fast + stabilizer circuit simulator optimized for analyzing quantum stabilizer + circuits and stabilizer-based error-correcting codes. + +* [qsim](https://github.com/quantumlib/qsim): A fast Schrödinger state-vector + simulator written in C++ and Python that integrates with Cirq to handle + large-scale classical simulations using vector instructions. + +* [TensorFlow Quantum](https://github.com/tensorflow/quantum): An open-source + framework for hybrid quantum-classical machine learning. + +Other projects include: + +* [Chromobius](https://github.com/quantumlib/Chromobius): A fast + implementation of the Möbius color-code decoder that approximates color + code decoding as a minimum weight matching problem. + +* [Tesseract Decoder](https://github.com/quantumlib/tesseract-decoder): A + specialized decoder built for quantum error correction research. + +* [ReCirq](https://github.com/quantumlib/ReCirq): A repository containing + research examples and published experiments leveraging Cirq. + +* [TypedUnits](https://github.com/quantumlib/TypedUnits): A specialized + library for managing units of measurement. + +* [Unitary](https://github.com/quantumlib/unitary): A library exploring + quantum computing concepts through games. + +## Get started with Quantum AI open-source software! + +We welcome contributions from the quantum research community! Everyone is +invited to participate in our projects. To get up to speed quickly, explore our +core software offerings below and refer to their respective README files and +other documentation. From 885c45d0d3418affe6d0df88744e6e04d34e3e50 Mon Sep 17 00:00:00 2001 From: mhucka Date: Wed, 17 Jun 2026 17:43:35 +0000 Subject: [PATCH 2/9] Put lists in alpha order --- README.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index c3344a9..abd48c4 100644 --- a/README.md +++ b/README.md @@ -15,22 +15,22 @@ following: creating, editing, manipulating, and running quantum circuits on hardware or in simulation. -* [Qualtran](https://github.com/quantumlib/Qualtran): A library of - blueprinted fault-tolerant algorithms and advanced resource estimation - tools used to cost out physical resource requirements. - * [OpenFermion](https://github.com/quantumlib/OpenFermion): An open-source library for compiling and translating problems in chemistry and materials science into quantum circuits. -* [Stim](https://github.com/quantumlib/Stim): A high-performance, fast - stabilizer circuit simulator optimized for analyzing quantum stabilizer - circuits and stabilizer-based error-correcting codes. +* [Qualtran](https://github.com/quantumlib/Qualtran): A library of + blueprinted fault-tolerant algorithms and advanced resource estimation + tools used to cost out physical resource requirements. * [qsim](https://github.com/quantumlib/qsim): A fast Schrödinger state-vector simulator written in C++ and Python that integrates with Cirq to handle large-scale classical simulations using vector instructions. +* [Stim](https://github.com/quantumlib/Stim): A high-performance, fast + stabilizer circuit simulator optimized for analyzing quantum stabilizer + circuits and stabilizer-based error-correcting codes. + * [TensorFlow Quantum](https://github.com/tensorflow/quantum): An open-source framework for hybrid quantum-classical machine learning. @@ -40,12 +40,12 @@ Other projects include: implementation of the Möbius color-code decoder that approximates color code decoding as a minimum weight matching problem. -* [Tesseract Decoder](https://github.com/quantumlib/tesseract-decoder): A - specialized decoder built for quantum error correction research. - * [ReCirq](https://github.com/quantumlib/ReCirq): A repository containing research examples and published experiments leveraging Cirq. +* [Tesseract Decoder](https://github.com/quantumlib/tesseract-decoder): A + specialized decoder built for quantum error correction research. + * [TypedUnits](https://github.com/quantumlib/TypedUnits): A specialized library for managing units of measurement. From 760e13e34dfe096547f8cd0a4f30a69df3b83310 Mon Sep 17 00:00:00 2001 From: mhucka Date: Wed, 17 Jun 2026 21:15:58 +0000 Subject: [PATCH 3/9] Many edits Summary of changes: * Removed "Google" from the title, to make it less in-your-face * Refactored the first couple of paragraphs of text * Added TNCO --- README.md | 33 +++++++++++++++++++-------------- 1 file changed, 19 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index abd48c4..28f2d30 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,21 @@ -# Welcome to Google Quantum AI's open-source projects +# Welcome to Quantum AI's open-source projects -Quantum AI and collaborators from all around the world maintain and develop -many open-source software projects on GitHub. We build best-in-class libraries -and utilities to advance applications research and error-correction research -for the future of fault-tolerant quantum computing. +The [Quantum AI](https://quantumai.google) team and collaborators from all +around the world maintain and develop open-source software projects for quantum +computing. We build best-in-class libraries and utilities to advance research +into applications and error correction for the future of fault-tolerant quantum +computing. Our open-source projects are found in repositories under the +Quantumlib organization and elsewhere on GitHub. ## Repositories -Quantum AI's open-source projects are found in repositories under the -Quantumlib organization and elsewhere on GitHub. Our major efforts include the -following: +Our major efforts include the following: * [Cirq](https://github.com/quantumlib/Cirq): A Python framework for creating, editing, manipulating, and running quantum circuits on hardware or in simulation. -* [OpenFermion](https://github.com/quantumlib/OpenFermion): An open-source +* [OpenFermion](https://github.com/quantumlib/OpenFermion): A framework library for compiling and translating problems in chemistry and materials science into quantum circuits. @@ -31,8 +31,9 @@ following: stabilizer circuit simulator optimized for analyzing quantum stabilizer circuits and stabilizer-based error-correcting codes. -* [TensorFlow Quantum](https://github.com/tensorflow/quantum): An open-source - framework for hybrid quantum-classical machine learning. +* [TensorFlow Quantum](https://github.com/tensorflow/quantum): A + framework for hybrid quantum-classical machine learning using + [TensorFlow](https://tensorflow.org). Other projects include: @@ -41,13 +42,17 @@ Other projects include: code decoding as a minimum weight matching problem. * [ReCirq](https://github.com/quantumlib/ReCirq): A repository containing - research examples and published experiments leveraging Cirq. + research examples and published experiments that use Cirq. + +* [Tensor Network Contraction Optimizer (TNCO)]( + https://github.com/google-research/tnco): a high-performance tensor network + contraction path optimizer for C++ and Python. * [Tesseract Decoder](https://github.com/quantumlib/tesseract-decoder): A specialized decoder built for quantum error correction research. -* [TypedUnits](https://github.com/quantumlib/TypedUnits): A specialized - library for managing units of measurement. +* [TypedUnits](https://github.com/quantumlib/TypedUnits): A utility + library for working with units of measurement. * [Unitary](https://github.com/quantumlib/unitary): A library exploring quantum computing concepts through games. From 0aa43281e04bb52c6f66d51f547bd1038248de67 Mon Sep 17 00:00:00 2001 From: mhucka Date: Wed, 17 Jun 2026 21:22:47 +0000 Subject: [PATCH 4/9] Add QAI logo file --- .assets/quantum-ai-vertical.svg | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 .assets/quantum-ai-vertical.svg diff --git a/.assets/quantum-ai-vertical.svg b/.assets/quantum-ai-vertical.svg new file mode 100644 index 0000000..b418727 --- /dev/null +++ b/.assets/quantum-ai-vertical.svg @@ -0,0 +1,19 @@ + + + + + + + + + + + + + + From 0d5448c5c3a232ad9ce3a92d6a3474ed62e25d33 Mon Sep 17 00:00:00 2001 From: mhucka Date: Wed, 17 Jun 2026 21:23:55 +0000 Subject: [PATCH 5/9] Retitle the page and add QAI logo --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 28f2d30..57479e4 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,6 @@ -# Welcome to Quantum AI's open-source projects +# Quantumlib + +Cirq logo The [Quantum AI](https://quantumai.google) team and collaborators from all around the world maintain and develop open-source software projects for quantum From 16520a5ff8eb2fe8566088625ede854677899a9a Mon Sep 17 00:00:00 2001 From: mhucka Date: Wed, 17 Jun 2026 21:29:41 +0000 Subject: [PATCH 6/9] Decided against using the logo after all This page shows up under github.com/quantumlib, which already has the logo anyway. --- .assets/quantum-ai-vertical.svg | 19 ------------------- README.md | 6 +----- 2 files changed, 1 insertion(+), 24 deletions(-) delete mode 100644 .assets/quantum-ai-vertical.svg diff --git a/.assets/quantum-ai-vertical.svg b/.assets/quantum-ai-vertical.svg deleted file mode 100644 index b418727..0000000 --- a/.assets/quantum-ai-vertical.svg +++ /dev/null @@ -1,19 +0,0 @@ - - - - - - - - - - - - - - diff --git a/README.md b/README.md index 57479e4..f7a9547 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,3 @@ -# Quantumlib - -Cirq logo - The [Quantum AI](https://quantumai.google) team and collaborators from all around the world maintain and develop open-source software projects for quantum computing. We build best-in-class libraries and utilities to advance research @@ -59,7 +55,7 @@ Other projects include: * [Unitary](https://github.com/quantumlib/unitary): A library exploring quantum computing concepts through games. -## Get started with Quantum AI open-source software! +## Get involved! We welcome contributions from the quantum research community! Everyone is invited to participate in our projects. To get up to speed quickly, explore our From 0225f42dc7b5ad4b040417032a8165fa0f137222 Mon Sep 17 00:00:00 2001 From: mhucka Date: Wed, 17 Jun 2026 22:02:17 +0000 Subject: [PATCH 7/9] Fix ordering mistake Apparently I don't know my alphabet ... --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index f7a9547..f3687b2 100644 --- a/README.md +++ b/README.md @@ -17,14 +17,14 @@ Our major efforts include the following: library for compiling and translating problems in chemistry and materials science into quantum circuits. -* [Qualtran](https://github.com/quantumlib/Qualtran): A library of - blueprinted fault-tolerant algorithms and advanced resource estimation - tools used to cost out physical resource requirements. - * [qsim](https://github.com/quantumlib/qsim): A fast Schrödinger state-vector simulator written in C++ and Python that integrates with Cirq to handle large-scale classical simulations using vector instructions. +* [Qualtran](https://github.com/quantumlib/Qualtran): A library of + blueprinted fault-tolerant algorithms and advanced resource estimation + tools used to cost out physical resource requirements. + * [Stim](https://github.com/quantumlib/Stim): A high-performance, fast stabilizer circuit simulator optimized for analyzing quantum stabilizer circuits and stabilizer-based error-correcting codes. From 086f10ff8ddf982c7b0015d7d8c6a2c30b8f17f4 Mon Sep 17 00:00:00 2001 From: mhucka Date: Sun, 21 Jun 2026 22:25:05 +0000 Subject: [PATCH 8/9] Streamline and shorten --- README.md | 67 ++++++++++++++++++------------------------------------- 1 file changed, 22 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index f3687b2..d9ae1da 100644 --- a/README.md +++ b/README.md @@ -9,55 +9,32 @@ Quantumlib organization and elsewhere on GitHub. Our major efforts include the following: -* [Cirq](https://github.com/quantumlib/Cirq): A Python framework for - creating, editing, manipulating, and running quantum circuits on hardware - or in simulation. - -* [OpenFermion](https://github.com/quantumlib/OpenFermion): A framework - library for compiling and translating problems in chemistry and materials - science into quantum circuits. - -* [qsim](https://github.com/quantumlib/qsim): A fast Schrödinger state-vector - simulator written in C++ and Python that integrates with Cirq to handle - large-scale classical simulations using vector instructions. - -* [Qualtran](https://github.com/quantumlib/Qualtran): A library of - blueprinted fault-tolerant algorithms and advanced resource estimation - tools used to cost out physical resource requirements. - -* [Stim](https://github.com/quantumlib/Stim): A high-performance, fast - stabilizer circuit simulator optimized for analyzing quantum stabilizer - circuits and stabilizer-based error-correcting codes. - -* [TensorFlow Quantum](https://github.com/tensorflow/quantum): A - framework for hybrid quantum-classical machine learning using +* [Cirq](https://github.com/quantumlib/Cirq): framework for creating, + manipulating, and running quantum circuits on hardware or in simulation. +* [OpenFermion](https://github.com/quantumlib/OpenFermion): framework for + creating and analyzing quantum algorithms to simulate electronic structures. +* [qsim](https://github.com/quantumlib/qsim): fast state-vector + simulator that integrates with Cirq and TensorFlow Quantum. +* [Qualtran](https://github.com/quantumlib/Qualtran): library for expressing + and analyzing fault-tolerant quantum algorithms. +* [Stim](https://github.com/quantumlib/Stim): tool for high-performance + simulation and analysis of quantum stabilizer circuits. +* [TensorFlow Quantum](https://github.com/tensorflow/quantum): framework for + hybrid quantum-classical machine learning using [TensorFlow](https://tensorflow.org). Other projects include: -* [Chromobius](https://github.com/quantumlib/Chromobius): A fast - implementation of the Möbius color-code decoder that approximates color - code decoding as a minimum weight matching problem. - -* [ReCirq](https://github.com/quantumlib/ReCirq): A repository containing - research examples and published experiments that use Cirq. - +* [Chromobius](https://github.com/quantumlib/Chromobius): fast Möbius decoder + for color codes used in quantum error correction. +* [ReCirq](https://github.com/quantumlib/ReCirq): repository of research + examples and published experiments that use Cirq. * [Tensor Network Contraction Optimizer (TNCO)]( - https://github.com/google-research/tnco): a high-performance tensor network - contraction path optimizer for C++ and Python. - -* [Tesseract Decoder](https://github.com/quantumlib/tesseract-decoder): A - specialized decoder built for quantum error correction research. - -* [TypedUnits](https://github.com/quantumlib/TypedUnits): A utility + https://github.com/google-research/tnco): high-performance library for + tensor networks. +* [Tesseract Decoder](https://github.com/quantumlib/tesseract-decoder): + search-based decoder for quantum error correction. +* [TypedUnits](https://github.com/quantumlib/TypedUnits): utility library for working with units of measurement. - -* [Unitary](https://github.com/quantumlib/unitary): A library exploring +* [Unitary](https://github.com/quantumlib/unitary): library for exploring quantum computing concepts through games. - -## Get involved! - -We welcome contributions from the quantum research community! Everyone is -invited to participate in our projects. To get up to speed quickly, explore our -core software offerings below and refer to their respective README files and -other documentation. From 65585a50ec3e8a56ba79259dcbc67e218c73d250 Mon Sep 17 00:00:00 2001 From: mhucka Date: Sun, 21 Jun 2026 22:26:38 +0000 Subject: [PATCH 9/9] Move README.md into proper location --- README.md => profile/README.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README.md => profile/README.md (100%) diff --git a/README.md b/profile/README.md similarity index 100% rename from README.md rename to profile/README.md