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.25 or 10)
  • 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