diff --git a/.gitignore b/.gitignore
new file mode 100644
index 000000000..317c88a60
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,70 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv*/
+env/
+.venv/
+*.egg-info/
+dist/
+build/
+
+# Data
+data/
+instance/
+*.npy
+*.faiss
+*.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Tests
+.pytest_cache/
+.hypothesis/
+.coverage
+htmlcov/
+.tox/
+
+# Logs
+logs/
+*.log
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Temporary
+*.tmp
+*.bak
+*.zip
+.~lock.*
+*.pid
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+.snapshots/
+.kiro/
+.mcp.json
+archives/
+backups*/
+frontend_broken*/
+
+# Node
+node_modules/
+
+# Models (large files)
+models/*.pt
+models/*.pth
+models/*.onnx
+*.safetensors