bookmark - modules initialized

README.md

@@ -4,6 +4,31 @@
 
 Impakt is a modular, scriptable Python toolkit for working with automotive crash test data. It reads ISO 13499 MME data natively, provides non-destructive signal processing, interactive web-based visualization, injury criteria calculation, and protocol-compliant report generation for Euro NCAP, US NCAP, and IIHS.
 
+## Quick Start
+
+```bash
+# Install
+uv sync --dev
+
+# Run tests (136 tests)
+uv run pytest tests/
+
+# View test metadata
+uv run impakt info tests/mme_data/3239
+
+# Launch web UI
+uv run impakt serve tests/mme_data/3239
+
+# Python scripting
+uv run python -c "
+from impakt import Session
+s = Session.open('tests/mme_data/3239')
+print(s)  # Session(3239, 133 channels)
+"
+```
+
+> See [[docs/STATUS.md]] for detailed project state, known issues, and next steps.
+
 ---
 
 ## Contents