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
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.
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file clai-2.27.0.tar.gz.
File metadata
- Download URL: clai-2.27.0.tar.gz
- Upload date:
- Size: 4.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8da767c7e2c1c9caee8b1e377e12bed6b0d45417d8c836a2dfd1f4fbe6f65120
|
|
| MD5 |
a4ba32f916d9324e9e166d90c9891a50
|
|
| BLAKE2b-256 |
b60dde1b30ddcb6094ec7d43b58c6172561ebc91ea29dec17a0a59b57d4e451d
|
Provenance
The following attestation bundles were made for clai-2.27.0.tar.gz:
Publisher:
ci.yml on pydantic/pydantic-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
clai-2.27.0.tar.gz -
Subject digest:
8da767c7e2c1c9caee8b1e377e12bed6b0d45417d8c836a2dfd1f4fbe6f65120 - Sigstore transparency entry: 2377871884
- Sigstore integration time:
-
Permalink:
pydantic/pydantic-ai@f9cd74f8ebca92a7acfa6346df7bf67f3f9e12cc -
Branch / Tag:
refs/tags/v2.27.0 - Owner: https://github.com/pydantic
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@f9cd74f8ebca92a7acfa6346df7bf67f3f9e12cc -
Trigger Event:
push
-
Statement type:
File details
Details for the file clai-2.27.0-py3-none-any.whl.
File metadata
- Download URL: clai-2.27.0-py3-none-any.whl
- Upload date:
- Size: 4.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dbd03ff5ebf41618a9725de109570fcd9f4eff24ddca836964d7bda29fa68030
|
|
| MD5 |
93b40e8f28b15e4400de70e5780daa59
|
|
| BLAKE2b-256 |
67a1d1553eb72e41ac5d56833c57660588f37ad6ff9febdf57f249a274d0785e
|
Provenance
The following attestation bundles were made for clai-2.27.0-py3-none-any.whl:
Publisher:
ci.yml on pydantic/pydantic-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
clai-2.27.0-py3-none-any.whl -
Subject digest:
dbd03ff5ebf41618a9725de109570fcd9f4eff24ddca836964d7bda29fa68030 - Sigstore transparency entry: 2377872434
- Sigstore integration time:
-
Permalink:
pydantic/pydantic-ai@f9cd74f8ebca92a7acfa6346df7bf67f3f9e12cc -
Branch / Tag:
refs/tags/v2.27.0 - Owner: https://github.com/pydantic
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@f9cd74f8ebca92a7acfa6346df7bf67f3f9e12cc -
Trigger Event:
push
-
Statement type:
