Skip to main content
praisonai models browses every model your install knows about — provider, capabilities, context window, and cost — so you pick the right one before you run.

​
Quick Start

1

List all models

praisonai models list
2

Filter by provider or name

praisonai models list --provider openai
praisonai models list gpt
3

Inspect a specific model

praisonai models describe gpt-4o
4

Validate a model ID before using it

praisonai models validate gpt-4o

​
Agent-centric example

from praisonaiagents import Agent

# `praisonai models describe gpt-4o` confirmed this model supports vision
agent = Agent(
    name="Vision Agent",
    instructions="Describe what's in the image.",
    llm="gpt-4o",
)
agent.start("Describe this screenshot.")

​
Subcommands

CommandPurpose
models list [SEARCH] [--provider P] [--json]List available models grouped by provider
models describe <model>Full capabilities, limits, cost, and notes for one model
models validate <model>Check whether an ID is valid; suggests alternatives on a miss

​
Flags

​
praisonai models list

FlagTypeDefaultDescription
search (positional)strNoneSubstring filter on model ID
--provider / -pstrNoneFilter to one provider
--jsonboolFalseEmit JSON instead of a Rich table

​
praisonai models describe <model>

FlagTypeDefaultDescription
model (positional)str—Model ID (e.g. gpt-4o)

​
praisonai models validate <model>

FlagTypeDefaultDescription
model (positional)str—Model ID to validate

​
Fallback behaviour

If litellm is not installed, the CLI falls back to a curated static list covering OpenAI, Anthropic, Google, Groq, and Ollama models. All three subcommands work against the static list. Install litellm for the full live catalogue: 
pip install 'praisonai[litellm]'

​
Best Practices

Catch typos in llm= before the agent fails on the first API call — praisonai models validate <id> exits 1 and suggests similar IDs on a miss.
Pipe praisonai models list --json into jq to filter by capability or cost in CI pipelines.
The static fallback covers only a handful of common models. Install praisonai[litellm] to unlock 100+ models with live pricing data.

Model Catalogue

Long-form feature article with output samples and caching details

Models Overview

Picking the right model for your workload

Auth

Store provider API keys before running agents

Run

Run agents with the model you picked