idliduReference
Env vars, hosts, and endpoints. Prefer product docs for behaviour.
Id environment
File: ~/.config/Id/env (mode 600). File wins over shell for ID_* on load.
| Variable | Meaning |
|---|---|
ID_API_KEY | Bearer key idl_… (required) |
ID_GATEWAY | Default https://gateway.idlidu.dev |
ID_API | Default https://api.idlidu.dev |
ID_SHELL_NET | 1 to allow shell network |
ID_BUDGET | Default turn budget override (if set) |
Shell helper: source ~/.config/Id/shellenv after install.
Public hosts
| URL | Role |
|---|---|
| www.idlidu.dev | Marketing + docs + install |
| app.idlidu.dev | Console |
| gateway.idlidu.dev | Inference |
| api.idlidu.dev | Account API |
| pay.idlidu.dev | Checkout |
Gateway endpoints
| Method | Path | Notes |
|---|---|---|
| GET | /health | Readiness / catalog |
| GET | /v1/models | OpenAI-shaped list |
| POST | /v1/chat/completions | Bearer idl_ |
Agent routes: see Agent API.
API endpoints (account)
| Method | Path | Notes |
|---|---|---|
| GET | /v1/me | Profile, balance, alerts |
| GET | /v1/credits | Balance + alerts |
| — | /v1/keys … | Mint / list / revoke (app + API) |
Prefer the app UI for day-to-day key and billing ops.
Install
curl -fsSL https://www.idlidu.dev/install.sh | bash
# or with key:
curl -fsSL https://www.idlidu.dev/install.sh | ID_API_KEY=idl_… bash