Update README.md

README.md

@@ -10,3 +10,21 @@ pinned: false
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# CodexFlow ΩΞ — Cashflow Acceleration System
+
+### What it Does
+- Harmonizes synthetic price signals with physical reality
+- Computes risk scores based on physical support
+- Generates accelerated cashflow estimates
+- Exposes JSON API + Gradio UI
+
+### Deploy
+- Upload this folder to a Hugging Face Space
+- Ensure `space.yaml` and `requirements.txt` exist
+- HF will auto-build and run
+
+### Usage
+Input a raw market price and inventory confidence to get:
+- Harmonized price
+- Distortion correction
+- Cashflow acceleration score