diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..808c5ae
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,68 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Byte-compiled / build / packaging
+build/
+dist/
+eggs/
+*.egg-info/
+.eggs/
+pip-wheel-metadata/
+wheelhouse/
+
+# Virtual environments
+.env
+.venv/
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs / editors
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
+
+# Jupyter
+.ipynb_checkpoints
+
+# Logs, databases, caches
+*.log
+*.sqlite3
+*.db
+*.db-journal
+.pytest_cache/
+.cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Testing / tooling
+.tox/
+.nox/
+.mypy_cache/
+.pyre/
+.pytype/
+
+# OS generated
+.DS_Store
+Thumbs.db
+
+# Sensitive / credentials
+.envrc
+.env.local
+credentials.json
+secrets.json
+*.pem
+*.key
+
+# Project-specific outputs
+data/
+outputs/
+reports/
+models/
+logs/
\ No newline at end of file