diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..7ed827c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,54 @@
+# ==========================================
+# Python - Cache files and compiled code
+# ==========================================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# ==========================================
+# Virtual environments
+# ==========================================
+venv/
+env/
+ENV/
+.env
+.venv
+
+# ==========================================
+# Distribution, packaging, and builds
+# ==========================================
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# ==========================================
+# Testing, coverage, and logs
+# ==========================================
+.pytest_cache/
+.coverage
+htmlcov/
+.pypy_cache/
+*.log
+
+# ==========================================
+# System junk (Windows / macOS)
+# ==========================================
+*.DS_Store
+Thumbs.db
+desktop.ini
\ No newline at end of file