Interfaces
A Pydantic AI agent is plain Python with no interface baked in: the same agent can run headless inside your backend, chat in a terminal, serve a web UI, power your own frontend, live inside an editor, or hold a spoken conversation. Each surface has its own page:
| Surface | What it looks like | Where |
|---|---|---|
| Your code | result = await agent.run('...'), an ordinary awaitable in any Python function, with typed output | Running agents |
| Terminal | agent.to_cli_sync(), or clai -a mymodule:agent against any agent you can import | CLI |
| Web chat | A built-in browser chat for any agent: clai web or agent.to_web() | Web Chat UI |
| Your frontend | Stream agent runs to your own UI over the AG-UI or Vercel AI protocols, including Vercel’s useChat React hooks | UI Event Streams |
| Editors | Serve an agent to Zed and other editors over the Agent Client Protocol | ACP (Harness, experimental) |
| Voice | The same agent, tools, and observability over a live audio session; voice is just another frontend | Realtime |
Because interfaces are separate from the agent, features work across all of them: deferred tools and approval surface wherever the agent runs (approval prompts in the CLI, approval UI events in your frontend), the same deployed agent can serve the web UI for your team and the AG-UI stream for your product at once, and a realtime session can hand its history to a text run and back. Complete agents work everywhere too: clai -a pydantic_ai_harness.coder:coder_agent runs the Harness’s Coder in your terminal.
More surfaces are on the way; follow the roadmap discussions for messaging channels and API endpoints.