Initial project structure and config

.gitignore

@@ -0,0 +1,55 @@
+# ==========================================
+# macOS System Files
+# ==========================================
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon?
+._*
+
+# ==========================================
+# Python & Bytecode
+# ==========================================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# ==========================================
+# Virtual Environments
+# ==========================================
+.venv/
+venv/
+ENV/
+env/
+env.bak/
+venv.bak/
+
+# ==========================================
+# Application Data & Cache
+# ==========================================
+# Keep the data/ directory structure, but ignore dynamic files inside it
+data/*
+!data/.gitkeep
+
+# Local log files and audio caches
+*.log
+*.wav
+*.mp3
+*.ogg
+
+# ==========================================
+# Environment & Secrets
+# ==========================================
+.env
+.env.local
+*.pem
+
+# ==========================================
+# IDEs & Editors
+# ==========================================
+.vscode/
+.idea/
+*.swp
+*.swo