clai

(pronounced "clay")

Command line interface to chat to LLMs, part of the Pydantic AI project.

Usage

You'll need to set an environment variable depending on the provider you intend to use.

E.g. if you're using OpenAI, set the OPENAI_API_KEY environment variable:

export OPENAI_API_KEY='your-api-key-here'

Then with uvx, run:

uvx clai

Or to install clai globally with uv, run:

uv tool install clai
...
clai

Or with pip, run:

pip install clai
...
clai

Either way, running clai will start an interactive session where you can chat with the AI model. Special commands available in interactive mode:

/exit: Exit the session
/markdown: Show the last response in markdown format
/multiline: Toggle multiline input mode (use Ctrl+D to submit)
/cp: Copy the last response to clipboard

Help

usage: clai [-h] [-l] [--version] [-m MODEL] [-a AGENT] [-t CODE_THEME] [--no-stream] [prompt]

Pydantic AI CLI v...

subcommands:
  web           Start a web-based chat interface for an agent
                Run "clai web --help" for more information

positional arguments:
  prompt                AI prompt for one-shot mode. If omitted, starts interactive mode.

options:
  -h, --help            show this help message and exit
  -l, --list-models     List all available models and exit
  --version             Show version and exit
  -m MODEL, --model MODEL
                        Model to use, in format "<provider>:<model>" e.g. "openai:gpt-5" or "anthropic:claude-sonnet-4-6". Defaults to "openai:gpt-5".
  -a AGENT, --agent AGENT
                        Custom Agent to use: a module path like "module:variable" or a YAML/JSON spec file like "agent.yml"
  -t CODE_THEME, --code-theme CODE_THEME
                        Which colors to use for code, can be "dark", "light" or any theme from pygments.org/styles/. Defaults to "dark" which works well on dark terminals.
  --no-stream           Disable streaming from the model

For more information on how to use it, see the CLI documentation.

Web Chat UI

Launch a web-based chat interface:

clai web -m openai:gpt-5.2

Web Chat UI

This will start a web server (default: http://127.0.0.1:7932) with a chat interface.

You can also serve an existing agent. For example, if you have an agent defined in my_agent.py:

from pydantic_ai import Agent

my_agent = Agent('openai:gpt-5.2', instructions='You are a helpful assistant.')

Launch the web UI with:

clai web --agent my_agent:my_agent

For full Web UI documentation, see Web Chat UI.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clai-2.35.0.tar.gz (4.7 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

clai-2.35.0-py3-none-any.whl (4.3 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file clai-2.35.0.tar.gz.

File metadata

Download URL: clai-2.35.0.tar.gz
Upload date: Aug 26, 2026
Size: 4.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for clai-2.35.0.tar.gz
Algorithm	Hash digest
SHA256	`6b27202e055b59f89313c4f8ef04892629f788f12b5ea6ad84f50b9ecf82df5a`
MD5	`67ffbc3a7cfacc7dbe0944a536224901`
BLAKE2b-256	`1fc57ff9c55adf1146cfa113810c01a7cb16f1347341eac47bdf9ab653c32ecc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for clai-2.35.0.tar.gz:

Publisher: ci.yml on pydantic/pydantic-ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: clai-2.35.0.tar.gz
- Subject digest: 6b27202e055b59f89313c4f8ef04892629f788f12b5ea6ad84f50b9ecf82df5a
- Sigstore transparency entry: 2593268121
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: pydantic/pydantic-ai@70f738de01059eb73b7e69b1e7c89365619926b8
- Branch / Tag: refs/tags/v2.35.0
- Owner: https://github.com/pydantic
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@70f738de01059eb73b7e69b1e7c89365619926b8
- Trigger Event: push