diff --git a/quantum-computing-basics/README.md b/quantum-computing-basics/README.md
new file mode 100644
index 0000000000..2bb55396bb
--- /dev/null
+++ b/quantum-computing-basics/README.md
@@ -0,0 +1,12 @@
+# Quantum Computing Basics
+
+Code examples from the Real Python tutorial on [Quantum Computing Basics](https://realpython.com/quantum-computing-basics/).
+
+## Requirements
+
+- Python 3.11+
+- Dependencies from `pyproject.toml`
+
+## Running the Examples
+
+The main example creates a simple quantum circuit with a Hadamard gate and measurement.
diff --git a/quantum-computing-basics/pyproject.toml b/quantum-computing-basics/pyproject.toml
new file mode 100644
index 0000000000..0b1465f967
--- /dev/null
+++ b/quantum-computing-basics/pyproject.toml
@@ -0,0 +1,9 @@
+[project]
+name = "quantum-computing-basics"
+version = "0.1.0"
+requires-python = ">=3.11"
+dependencies = [
+    "qiskit==2.1.1",
+    "matplotlib",
+    "pylatexenc",
+]
diff --git a/quantum-computing-basics/quantum_circuit.png b/quantum-computing-basics/quantum_circuit.png
new file mode 100644
index 0000000000..c90650acba
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")