sophon

Command-line client for the Sophon catalog of AI evals, models, tools (RL environments / datasets), leaderboards, papers, organizations, and people.

It is a zero-dependency wrapper over the public read API (/api/v1): no database, no API key, no repo checkout. By default it queries production.

Install

npm install -g sophon-at      # then use `sophon …`
# or run once without installing:
npx sophon-at search "swe-bench"

Requires Node >= 18.

Usage

sophon search "swe-bench"                 # full-text search across the catalog
sophon search reasoning --type eval --per 5
sophon search reasoning --sort title      # A→Z within each type (-title reverses)
sophon get eval swe-bench                 # one entity, formatted
sophon get model gpt-5
sophon get tool prime-primeintellect-mini-swe-agent-plus
sophon paper pwc-50106 --text             # full text / abstract as plain text
sophon paper pwc-50106 --pdf              # print the PDF url
sophon api                                # API index

get accepts singular or plural types: evals models tools leaderboards organizations people capabilities papers.

For agents and scripts

Output is the human-readable summary on a TTY and JSON when piped (or with --json). So agents and scripts get structured data automatically:

sophon get model gpt-5 | jq .scores       # JSON because stdout is not a TTY
sophon search "swe-bench" --json | jq '.results.eval[].slug'
sophon get eval swe-bench --no-json       # force the human summary even when piped

Errors are emitted as {"error": "..."} on stdout in JSON mode. Exit codes: 0 ok, 1 runtime/remote error, 2 usage error.

Flags

| flag | meaning | | --- | --- | | --json | force JSON output (default when stdout is not a TTY) | | --no-json | force the human summary even when piped | | --type T | search: restrict to one entity type | | --per N | search: results per type (1..30, default 8) | | --sort S | search: order within each type — relevance (default), title, recent; prefix - to reverse |

Environment

| var | meaning | | --- | --- | | SOPHON_BASE | base url, default https://sophon.at (e.g. http://localhost:3939) | | SOPHON_JSON | 1/0 to force JSON on/off (overridden by --json / --no-json) | | NO_COLOR | disable ANSI colors |

License

MIT