abliteration CLI

Command-line client for the abliteration.org catalog API. The same catalog you browse on the web, served as JSON from your terminal — models, datasets, methods, indices, and the curated field timeline.

Install

npm install -g @abliteration/cli

Or use the installer that also works on machines without Node.js installed:

curl -sSf https://abliteration.org/install | bash

Both give you two commands: abliteration (the full name) and abl (the short one). Everywhere you can type one, you can type the other.

Getting started

$ abl login
# Opens https://abliteration.org/shop/account#api-keys in your browser.
# Generate a key on that page, paste it here.

$ abl models --method M4 --limit 5
ID                                                     Method  Family   License      Downloads
-----------------------------------------------------  ------  -------  -----------  ---------
mlabonne/Qwen3-30B-A3B-abliterated                     M4      qwen     apache-2.0     249,452
mlabonne/Meta-Llama-3.1-8B-Instruct-abliterated-GGUF   M4      llama-3  llama-3         30,768
mlabonne/NeuralDaredevil-8B-abliterated                M4      llama-3  llama-3         14,765
mlabonne/gemma-2-9b-it-abliterated                     M4      gemma-2  gemma           12,890
mlabonne/Daredevil-8B-abliterated                      M4      llama-3  llama-3         11,432
cost: 5 cr · balance: 495 · rate: 59/60

Commands

| Command | What it does | Cost | |---|---|---| | abl login | Sign in, save key locally | free (once) | | abl logout | Remove local key | free | | abl whoami | Show key prefix + balance | 5 cr | | abl credits | Show credit balance | 5 cr | | abl models | List catalog models | 5-300+ cr | | abl models <id> | Fetch one model | 10 cr | | abl authors | List authors | 5-15 cr | | abl authors <id> | Fetch one author | 1 cr | | abl methods | List M-code taxonomy | 5-15 cr | | abl methods <id> | Fetch one method | 1 cr | | abl datasets | List alignment datasets | 5-15 cr | | abl datasets <id> | Fetch one dataset | 1 cr | | abl indices | All four flagship indices | 20 cr | | abl indices <id> | One index with history | 10 cr | | abl timeline | Curated field events | 50 cr |

Every command has --help for full flag documentation.

Pricing shape

Model routes carry an anti-scrape price shape: the cost of abl models grows steeply as you page deeper into the catalog. A filtered lookup up to 200 rows always costs 5 credits. A full 1000-row page on the first page costs 300; on page 10, 5100. Filter cheap, dump expensive — see /api#pricing for the full formula.

Every response prints the actual cost and your remaining balance in the footer.

Machine-readable output

Add --json to any command to get the full envelope as JSON on stdout:

$ abl models --method M4 --limit 3 --json
{
  "data": [ ... ],
  "cost": 5,
  "credits_remaining": 495,
  "rate_limit_limit": 60,
  "rate_limit_remaining": 59,
  "metering": "billed",
  "request_id": "..."
}

Environment

• ABLITERATION_API_KEY — overrides ~/.abliteration/config.json
• ABLITERATION_API_BASE — overrides https://abliteration.org
• ABL_DEBUG=1 — print full stack traces on errors

Docs

• Full API reference: https://abliteration.org/api
• Machine-readable spec: https://abliteration.org/api/v1/openapi.json
• Source: https://github.com/neymark/abliteration/tree/main/cli

License

MIT