Skip to Content
New in v0.1.0 OpenQASM export: run fqkit circuits on real IBM hardware
DocumentationIntroduction

Introduction

FQkit is a small Python framework for building and simulating quantum circuits. The source stays short on purpose, so you can learn how a quantum computer works by reading it and changing it.

ℹ️

FQkit is free and open source. It depends only on Python and NumPy, and it can export circuits to OpenQASM so you can run them on real hardware. IBM is reached through Qiskit Runtime. IonQ, Rigetti, IQM, and AQT are reached through Amazon Braket. Those SDKs are optional extras.

Why FQkit?

Most quantum frameworks are large and abstract. FQkit is deliberately small. Qubits, gates, operations, circuits, simulation, and measurement each live in a short module you can read. You can hold the whole thing in your head.

Features

  • Qubits and parameterized gates: H, RX, RY, RZ
  • Multi-qubit gates: CNOT, CZ, SWAP, Toffoli
  • Circuit construction: QuantumCircuit with validation
  • Parameter binding: symbolic parameters for variational circuits
  • Statevector simulator: run returns the final quantum state
  • Measurement: measure_all samples bitstrings from the state
  • OpenQASM 2.0 export: to_qasm bridges to Qiskit and real hardware
  • Hardware jobs: submit(qc, "ibm") or "ionq", "rigetti", "iqm", "aqt"

How these docs are organized

PageWhat you’ll learn
InstallationGetting FQkit onto your machine
Quick StartYour first entangled circuit
GatesThe gate library and how gates work
CircuitsBuilding circuits with QuantumCircuit
Simulation & MeasurementRunning circuits and reading results
Parameters & BindingVariational circuits
OpenQASM & HardwareExporting a circuit to OpenQASM
HardwareAccounts, runtime, job submission, and results
API ReferenceEvery public function and class
ApplicationsChemistry, telecommunications, physics, cryptography, and where to go next
Last updated on