Command-line interface for the OpenModels registry — browse models, compare providers, and check telemetry from your terminal.
# Install globally npm install -g openmodels-cli # Or run without installing npx openmodels-cli
Requires Node.js ≥ 22.0.0.
# List all models openmodels models list # Get details about a specific model openmodels models info claude-opus-4-6 # Compare providers for a model openmodels compare gpt-5 # Search models openmodels search "code generation" # Check provider health openmodels telemetry anthropic
List models with optional filters.
openmodels models list openmodels models list --capability reasoning openmodels models list --modality text --sort context_window openmodels models list --page 2 --limit 20
| Option | Description |
|---|---|
--capability <cap> |
Filter by capability (chat, completion, function-calling, code-generation, reasoning, vision, audio, embeddings, fine-tuning) |
--modality <mod> |
Filter by modality (text, image, audio, video, code) |
--sort <field> |
Sort by: name, recency, context_window, providers |
--page <n> |
Page number |
--limit <n> |
Results per page |
Display detailed information about a specific model including capabilities, modalities, context window, licensing, and provider availability with pricing.
openmodels models info claude-opus-4-6 openmodels models info deepseek-r1 --format json
List inference providers.
openmodels providers list openmodels providers list --search anthropic openmodels providers list --page 1 --limit 10
| Option | Description |
|---|---|
--search <term> |
Filter providers by search term |
--page <n> |
Page number |
--limit <n> |
Results per page |
Compare all providers offering a specific model side-by-side, showing pricing, rate limits, and regions.
openmodels compare gpt-5 openmodels compare claude-opus-4-6 --sort rate_limit openmodels compare deepseek-r1 --format yaml
| Option | Description |
|---|---|
--sort <field> |
Sort by: price (default), rate_limit |
Full-text search across models by name or description.
openmodels search "code generation" openmodels search "vision" --capability chat --limit 5 openmodels search "reasoning"
| Option | Description |
|---|---|
--capability <cap> |
Additionally filter by capability |
--limit <n> |
Maximum number of results |
View provider health status and latency metrics.
openmodels telemetry anthropic openmodels telemetry together-ai --period 7d openmodels telemetry openai --format json
| Option | Description |
|---|---|
--period <period> |
Time period: 1d, 7d, 30d |
Generate shell completion scripts.
# Bash openmodels completions bash >> ~/.bashrc # Zsh openmodels completions zsh > ~/.zfunc/_openmodels # Fish openmodels completions fish > ~/.config/fish/completions/openmodels.fish
All commands support the --format flag:
openmodels models list --format table # Default — colored, aligned columns openmodels models list --format json # Machine-readable JSON openmodels models list --format yaml # YAML output
JSON and YAML formats are designed for piping to other tools and CI/CD pipelines.
Create ~/.openmodelsrc to store default settings:
{
"api_url": "https://api.openmodels.run",
"api_key": "om_...",
"format": "table",
"no_color": false
}| Variable | Description |
|---|---|
OPENMODELS_API_URL |
API base URL (default: https://api.openmodels.run) |
OPENMODELS_API_KEY |
API authentication key |
NO_COLOR |
Disable colored output (any value) |
- CLI flags (
--api-url,--api-key,--format,--no-color) - Environment variables
- Config file (
~/.openmodelsrc) - Defaults
| Flag | Description |
|---|---|
--format <type> |
Output format: table, json, yaml |
--api-url <url> |
API base URL |
--api-key <key> |
API authentication key |
--no-color |
Disable colored output |
--verbose |
Show detailed error information |
-h, --help |
Show help |
-V, --version |
Show version |
OpenModels is an open-source, community-maintained registry of LLM models, inference providers, and provider-model mappings. It tracks 88+ models across 42+ providers with pricing, rate limits, and availability data.
- Website: openmodels.run
- API: api.openmodels.run
- Registry: github.com/openmodelsrun/openmodels
- Docs: openmodels.run/docs
git clone https://github.com/openmodelsrun/cli.git cd cli npm install npm run build npm test
MIT