diff --git a/quantum-computing-basics/README.md b/quantum-computing-basics/README.md
new file mode 100644
index 0000000000..65c60a306e
--- /dev/null
+++ b/quantum-computing-basics/README.md
@@ -0,0 +1,16 @@
+# Quantum Computing Basics With Qiskit
+
+Code examples for the Real Python tutorial on [Quantum Computing Basics With Qiskit](https://realpython.com/quantum-computing-basics/).
+
+## Requirements
+
+- Python 3.10+
+- Dependencies from `pyproject.toml`
+
+## Running the Examples
+
+You can use uv to run the main example, which creates a simple quantum circuit with a Hadamard gate and measurement:
+
+```sh
+$ uv run quantum_circuit.py
+```
diff --git a/quantum-computing-basics/pyproject.toml b/quantum-computing-basics/pyproject.toml
new file mode 100644
index 0000000000..36b08893d8
--- /dev/null
+++ b/quantum-computing-basics/pyproject.toml
@@ -0,0 +1,7 @@
+[project]
+name = "quantum-computing-basics"
+version = "0.1.0"
+requires-python = ">=3.10"
+dependencies = [
+    "qiskit[visualization]==2.2.3"
+]
diff --git a/quantum-computing-basics/quantum_circuit.png b/quantum-computing-basics/quantum_circuit.png
new file mode 100644
index 0000000000..a009fbb7eb
Binary files /dev/null and b/quantum-computing-basics/quantum_circuit.png differ
diff --git a/quantum-computing-basics/quantum_circuit.py b/quantum-computing-basics/quantum_circuit.py
new file mode 100644
index 0000000000..8aa786c7ec
--- /dev/null
+++ b/quantum-computing-basics/quantum_circuit.py
@@ -0,0 +1,10 @@
+from qiskit import ClassicalRegister, QuantumCircuit, QuantumRegister
+
+qr = QuantumRegister(1, name="quantum")
+cr = ClassicalRegister(1, name="classical")
+qc = QuantumCircuit(qr, cr)
+
+qc.h(0)
+qc.measure(0, 0)
+
+qc.draw("mpl", filename="quantum_circuit.png")