diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..3a5d94c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,23 @@
+# Python
+*.egg-info/
+**/__pycache__/
+*.pyc
+*.pyo
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test & coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# UV lock file
+uv.lock
+
+# IDE / OS
+.idea/
+.vscode/
+*.DS_Store