# models
<p align="center">
<a href="https://crates.io/crates/modelsdev"><img src="https://img.shields.io/crates/v/modelsdev.svg?label=version" alt="Version"></a>
<a href="https://github.com/arimxyer/models/actions/workflows/update-benchmarks.yml"><img src="https://github.com/arimxyer/models/actions/workflows/update-benchmarks.yml/badge.svg" alt="Benchmarks"></a>
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
<a href="https://buymeacoffee.com/arimxyer"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?logo=buy-me-a-coffee&logoColor=black" alt="Buy Me a Coffee"></a>
</p>
TUI and CLI for browsing AI models, benchmarks, coding agents, and provider statuses.
## Highlights
- **~4,000+ models** across 85+ providers from [models.dev](https://models.dev) — filter by capability, price, context, and provider category
- **~400 benchmark entries** from [Artificial Analysis](https://artificialanalysis.ai) — compare models head-to-head with scatter plots and radar charts
- **11+ coding agents** tracked with version detection, changelogs, and GitHub integration
- **22 provider statuses** monitored live across 7 status page platforms
## What's New in v0.11.3
- **Status CLI** — `models status list`, `show`, `sources`, and `status` commands with interactive picker and JSON output
- **Configurable aliases** — customize symlink names via `[aliases]` in config.toml; `models link` creates all three
- **Status tab** — live provider health monitoring with incidents, maintenance, and customizable tracking
- **Agent service health** — live operational status from provider status pages in the agents detail panel and CLI
## Install
### Homebrew (macOS/Linux)
```bash
brew install models
```
### Cargo (any platform)
```bash
cargo install modelsdev
```
### Scoop (Windows)
```powershell
scoop install extras/models
```
### AUR (Arch Linux)
```bash
paru -S models-bin
```
Pre-built binaries, `.deb`, and `.rpm` packages are available on [GitHub Releases](https://github.com/arimxyer/models/releases). See the [Installation wiki page](https://github.com/arimxyer/models/wiki/Installation) for all methods, shell completions, and command aliases.
## Quick Start
```bash
models
```
<video src="https://github.com/user-attachments/assets/2e205916-5998-42b2-b60e-c8ffd7b2a668" controls width="100%"></video>
Navigate with arrow keys, switch tabs with `[`/`]`, search with `/`, and press `?` for context-aware help. See [Getting Started](https://github.com/arimxyer/models/wiki/Getting-Started) for a full walkthrough.
## Features
### Models — browse and compare AI models
Three-column layout with providers, model list, and rich detail panel. RTFO capability indicators, 6 filter keys, sort by name/date/cost/context, cross-provider search, and copy-to-clipboard.
[Models wiki page](https://github.com/arimxyer/models/wiki/Models) • CLI: `models list`, `models show`, `models search`, `models providers`
### Agents — track AI coding assistants
Curated catalog of 12+ agents with automatic version detection, GitHub release tracking, styled changelogs with search and match navigation, and live service health from provider status pages.
[Agents wiki page](https://github.com/arimxyer/models/wiki/Agents) • CLI: `agents status`, `agents <tool>`, `agents latest`, `agents list-sources`
### Benchmarks — compare model performance
~400 entries with quality indexes, speed, and pricing. Compare mode with head-to-head tables, scatter plots, and radar charts. Filter by creator, region, type, reasoning, and open/closed source.
[Benchmarks wiki page](https://github.com/arimxyer/models/wiki/Benchmarks) • CLI: `models benchmarks list`, `models benchmarks show`
### Status — monitor provider health
Live health monitoring for 22 AI providers across 7 status page platforms. Overall dashboard with health gauge, incident and maintenance cards. Provider detail with grouped services, incidents, and scheduled maintenance.
[Status wiki page](https://github.com/arimxyer/models/wiki/Status) • CLI: `models status list`, `models status show`, `models status status`
## Documentation
Full documentation lives in the [wiki](https://github.com/arimxyer/models/wiki):
| [Installation](https://github.com/arimxyer/models/wiki/Installation) | All install methods, shell completions, command aliases |
| [Getting Started](https://github.com/arimxyer/models/wiki/Getting-Started) | First launch, navigation, basic usage |
| [Models](https://github.com/arimxyer/models/wiki/Models) | Models tab and CLI commands |
| [Agents](https://github.com/arimxyer/models/wiki/Agents) | Agents tab and CLI commands |
| [Benchmarks](https://github.com/arimxyer/models/wiki/Benchmarks) | Benchmarks tab and CLI commands |
| [Status](https://github.com/arimxyer/models/wiki/Status) | Status tab and CLI commands |
| [Configuration](https://github.com/arimxyer/models/wiki/Configuration) | Config file, custom agents, tracked providers |
| [Data Sources](https://github.com/arimxyer/models/wiki/Data-Sources) | Where the data comes from |
| [Architecture](https://github.com/arimxyer/models/wiki/Architecture) | Internal design for contributors |
| [Contributing](https://github.com/arimxyer/models/wiki/Contributing) | How to contribute |
## Data Sources
- **Models**: [models.dev](https://models.dev) by [SST](https://github.com/sst/models.dev)
- **Benchmarks**: [Artificial Analysis](https://artificialanalysis.ai)
- **Agents**: Curated catalog in [`data/agents.json`](data/agents.json) — contributions welcome!
- **Status**: Official provider status pages ([Statuspage](https://www.atlassian.com/software/statuspage), [BetterStack](https://betterstack.com), [Instatus](https://instatus.com), [incident.io](https://incident.io), and more)
## Contributing
Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) before submitting a PR.
This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).
## License
MIT