commit b14b14eb309477e3bfd7f36e741594f64ec3058d
Author: elmadani <Elmadani.SALKA@proton.me>
Date:   Wed Feb 25 00:53:33 2026 +0000

    Initial commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fca7f3a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+# IX Relay
+*Part of the Inference-X Ecosystem*
+
+[![License: BSL-1.1](https://img.shields.io/badge/License-BSL_1.1-orange.svg)](LICENSE)
+
+**Federated inference network. Your idle hardware earns you compute credits.**
+
+IX Relay is the khettara for AI power: ancient Moroccan underground canals that
+deliver water using only gravity. IX Relay delivers inference using idle community compute.
+
+```
+Your GPU sits idle at night
+  → IX Relay runs community inference jobs
+  → You earn compute credits
+  → Use credits when you need heavy inference
+```
+
+## Deploy
+```bash
+pip install fastapi uvicorn
+python ix_relay.py
+# → API at http://localhost:7938
+```
+
+## API
+```
+POST /register-node     — Register your IX instance as a node
+GET  /nodes             — List active relay nodes
+POST /create-account    — Create account (10 free credits)
+GET  /credits/{id}      — Check credit balance
+GET  /health            — Service status
+```
+
+## How Credits Work
+- Each inference job costs 0.1–1.0 credits depending on model size
+- Each inference job completed earns the node 0.1–1.0 credits
+- New accounts start with 10 free credits
+
+## Philosophy
+The khettara: built by many, maintained by many, flowing to anyone who needs it.
+
+Built in Morocco for the world. 🇲🇦
+
+## License
+[Business Source License 1.1](LICENSE)
+**Author:** Salka Elmadani