diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..8f51151
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,24 @@
+# Python cache and local artifacts
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Environment and local tooling metadata
+.venv/
+venv/
+env/
+.env
+.env.*
+
+# Test and coverage output
+.coverage
+.coverage.*
+htmlcov/
+.pytype/
+
+# Editor and OS noise
+.DS_Store
+.idea/
+.vscode/