# 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