Pydantic AI with PraisonAI

Run PraisonAI agents through Pydantic AI via praisonai-frameworks

from praisonaiagents import Agent

agent = Agent(
    name="Calculator",
    instructions="Return only the numeric answer.",
    llm="openai/gpt-4o-mini",
)

agent.start("What is 3 + 3?")

The same agent can run through Pydantic AI when you set framework: pydantic_ai in agents YAML — or use the Agent class directly as above.

Quick Start

1. Install

   pip install "praisonai[pydantic-ai]"
   export OPENAI_API_KEY=sk-...

2. Create agents.yaml

   framework: pydantic_ai
   topic: math
   roles:
     calculator:
       role: Calculator
       goal: Compute exactly
       backstory: Return only the numeric answer.
       tasks:
         add:
           description: What is 3 + 3?
           expected_output: "6"

3. Run

   praisonai agents.yaml --framework pydantic_ai

Models

Supported Patterns

Handoffs

Use the same handoff.to pattern as OpenAI Agents — one router role with a single task, specialists without tasks:

framework: pydantic_ai
topic: language help
roles:
  triage:
    role: Triage Agent
    handoff:
      to:
        - English Agent
    tasks:
      route:
        description: Help with {topic}
  english:
    role: English Agent
    goal: Reply in English only
    backstory: English specialist.

Multi-task configs with handoff.to fall back to sequential execution (OpenAI parity).

Migrate from Pydantic AI

praisonai migrate converts Pydantic AI code to PraisonAI automatically.

1. Point migrate at your Pydantic AI project

   praisonai migrate ./my-pydantic-ai-app

2. What gets rewritten

   Pydantic AI	PraisonAI
   from pydantic_ai import Agent	from praisonaiagents import Agent
   agent.run_sync("...")	agent.start("...")

3. Apply the changes

   praisonai migrate ./my-pydantic-ai-app --apply

Doctor Check

The Pydantic AI runtime card reports:

Limitations

Best Practices

Related