diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..f4d34a0
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,34 @@
+# Personal tokens: never commit or import this file
+.env
+
+# Virtual environment
+.venv
+venv
+
+# Byte-compiled and cached files
+__pycache__
+*.py[cod]
+*$py.class
+
+# Packaging and build output (build/ also holds the Doxygen HTML)
+build/
+dist/
+*.egg-info/
+*.egg
+.eggs/
+pip-wheel-metadata/
+
+# Test, lint and type-check caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Editors and operating systems
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db