How to Build Your First Quantum Circuit Step-by-Step

 Nice — let’s build your first quantum circuit step-by-step (using Qiskit + Aer simulator). I’ll keep it practical: install, write code, run, and explain what you see. No prior quantum hardware required.

Prerequisites

Python 3.8+ installed.

A terminal (or Jupyter / Colab).

Install Qiskit: pip install qiskit.

IBM Quantum

Quick concept refresher (2 lines)

Qubit = quantum bit (can be |0⟩, |1⟩ or a superposition).

Gates (H, X, CNOT, …) transform qubit states. Measurement collapses a qubit to classical 0/1.

Step-by-step: build, run, inspect

1) (Optional) create a venv

python -m venv qenv

# mac/linux

source qenv/bin/activate

# windows (powershell)

qenv\Scripts\Activate.ps1

2) Install Qiskit

pip install qiskit

(If you want extras: pip install qiskit[visualization] for plotting.)

IBM Quantum

+1

3) Write your first circuit — Single-qubit superposition (Hadamard)

Create a file first_circuit.py and paste this:

# first_circuit.py

from qiskit import QuantumCircuit, transpile

from qiskit_aer import AerSimulator

# 1 qubit, 1 classical bit

qc = QuantumCircuit(1, 1)

# Put qubit into superposition

qc.h(0) # Hadamard gate -> (|0> + |1>)/√2

# Measure the qubit into the classical bit

qc.measure(0, 0)

# Print an ASCII drawing of the circuit

print(qc.draw(output='text'))

# Simulate with AerSimulator

sim = AerSimulator()

# Transpile/compile to the simulator's instruction set

tqc = transpile(qc, sim)

# Run with 1024 shots (repeated experiments)

job = sim.run(tqc, shots=1024)

result = job.result()

# Get counts (how many times each outcome occurred)

counts = result.get_counts()

print("Counts:", counts)

What this does: Hadamard puts the qubit in equal superposition; measuring many times yields ~50/50 0 vs 1 (with enough shots). Expect roughly equal counts for '0' and '1'.

qiskit.github.io

+1

4) Run it

python first_circuit.py

You should see the circuit drawing and something like Counts: {'0': 512, '1': 512} (numbers will vary by run).

Example 2 — Make a Bell pair (entanglement)

Replace code body with:

from qiskit import QuantumCircuit, transpile

from qiskit_aer import AerSimulator

qc = QuantumCircuit(2, 2)

qc.h(0) # create superposition on qubit 0

qc.cx(0, 1) # entangle qubit 0 with qubit 1

qc.measure([0,1], [0,1])

print(qc.draw(output='text'))

sim = AerSimulator()

tqc = transpile(qc, sim)

result = sim.run(tqc, shots=1024).result()

print(result.get_counts())

Expected behavior: Measurements will be correlated — mostly 00 and 11 (bell pairing), showing entanglement.

qiskit.github.io

Want to visualize the circuit or histogram?

qc.draw(output='mpl') opens a matplotlib diagram (needs matplotlib).

Use Qiskit’s plot_histogram(counts) to view measurement distribution (requires qiskit.visualization / matplotlib).

qiskit.github.io

Run on real IBM quantum hardware (quick notes)

Create an IBM Quantum account (quantum.ibm.com) and get an API token.

Install qiskit-ibm-runtime or qiskit-ibm-provider and authenticate.

Select a backend (device) from your provider and submit your transpiled circuit; jobs are queued and noisy — results will reflect device noise. Use job_monitor to watch progress.

IBM Quantum

Tips, pitfalls & best practices

Shots: more shots → smoother statistics (1024–8192 common).

Transpile: always transpile() for the chosen backend to optimize gates and mapping.

qiskit.github.io

Noise: real devices introduce errors — simulators give ideal/noise-free runs unless you load a noise model.

qiskit.github.io

APIs evolve: Qiskit has grown and some APIs change between major versions — check the official install & simulator docs if something breaks.

IBM Quantum

Next steps (where to go from here)

Make small variants: add X gate, measure different bases, try 3-qubit GHZ state.

Implement Deutsch’s algorithm or a quantum random number generator (great next projects).

Explore Qiskit tutorials and IBM Quantum learning modules for guided exercises.

IBM Quantum

+1

Learn Quantum Computing Course in Hyderabad

Read More

Top Beginner Quantum Computing Projects to Try

Practical Learning & Projects

How Quantum Computing Courses Differ by Region

Are Quantum Computing MOOCs Worth It?