diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..3d70b96
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,44 @@
+# OS/editor noise
+.DS_Store
+.idea/
+.vscode/
+
+# Local environment files
+.env
+.env.local
+.env.*.local
+
+# Python artifacts
+__pycache__/
+*.py[cod]
+*.pyd
+*.so
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+dist/
+build/
+*.egg-info/
+.venv/
+python/.venv/
+
+# Go artifacts
+bin/
+*.test
+coverage.out
+
+# Logs and temp files
+*.log
+*.tmp
+*.swp
+
+# Keep generated protocol/API code versioned for reproducible builds.
+!gen/
+!gen/**
+
+# But never track Python bytecode/cache artifacts from generated code.
+gen/**/__pycache__/
+gen/**/*.py[cod]