diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..98af309
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,102 @@
+# Byte-compiled / caches
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Jupyter
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv / poetry
+Pipfile.lock
+.poetry/
+
+# Virtual environments
+env/
+venv/
+ENV/
+env.bak/
+.venv/
+venv.bak/
+
+# IDEs / editors
+.vscode/
+.idea/
+*.sublime-workspace
+*.sublime-project
+
+# Editor temporary files
+*~
+*.swp
+*.swo
+
+# Project-specific caches
+.mypy_cache/
+.pytype/
+.ruff_cache/
+.pyre/
+.ropeproject/
+
+# C extensions
+*.so
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs & databases
+*.log
+*.sql
+*.sqlite3
+
+# Secrets / env
+.env
+.env.*