diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..a87d55d
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,21 @@
+# Python bytecode and test/tool caches
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Local runtime data
+logs/
+exports/
+
+# Environment/secrets
+.env
+.env.*
+!.env.example