diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..c830f83
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,74 @@
+# macOS
+.DS_Store
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Local configuration and secrets
+.env
+.env.*
+!.env.example
+settings.json
+secrets.*
+*.pem
+*.key
+*.p12
+*.pfx
+id_rsa*
+id_ed25519*
+
+# App output and caches
+web/output/
+PyWebview/web/output/
+.hf_cache/
+*.log
+
+# Generated media and 3D assets
+*.png
+*.jpg
+*.jpeg
+*.webp
+*.glb
+*.gltf
+*.blend
+*.hdr
+*.exr
+*.mp4
+*.mov
+*.zip
+*.tar.gz
+
+# Local model weights
+*.safetensors
+*.ckpt
+*.pt
+*.pth
+*.onnx
+*.bin
+
+# Node and lockfile leftovers
+node_modules/
+package-lock.json
+npmCargo.lock
+*.lock
+
+# Native build artifacts
+*.o
+*.dylib
+*.a
+*.so
+*.exe
+debug*.exe