Quickstart
From zero to a metered Id turn. Needs Node.js 20+ and a browser for signup.
1. Create an account
Sign up at app.idlidu.dev/signup (email + password). Then open API keys.
2. Mint a key
- Name — e.g.
laptop - Budget ($ / turn) — default Id turn cap (e.g.
0.25or10) - Hard limit ($ lifetime) — gateway stops the key when spent would exceed this
Copy the idl_… secret now — it is shown once.
3. Install Id
curl -fsSL https://www.idlidu.dev/install.sh | bash
source ~/.config/Id/shellenv
Id health
Or pass the key at install time:
curl -fsSL https://www.idlidu.dev/install.sh | ID_API_KEY=idl_… bash
Config lives in ~/.config/Id/env (mode 600). Details:
install page · CLI docs.
4. First run
Id ask "Explain this repo in three bullets" --budget 0.10 --yolo
# or interactive:
Id Boot should show balance (account credits) and budget …/turn (this turn’s cap from the key).
5. Add credits
When checkout is enabled: Billing → pick an INR or USD pack → PayU. See Billing docs and Pricing.
Using the gateway without Id
Any OpenAI-compatible client can hit
https://gateway.idlidu.dev/v1/chat/completions with
Authorization: Bearer idl_…. See Gateway.
Next: Id documentation · Bottom routing · Reference