Initial commit

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