Skip to main content
Pick which framework runs a chat turn — PraisonAI is built in, and installing praisonai-frameworks adds CrewAI, AutoGen, LangGraph, Agno, Google ADK, OpenAI Agents SDK and Pydantic AI.
The default framework = "praisonai" runs the built-in agent. Any other name routes the turn through that framework’s adapter, discovered by the praisonai-frameworks extras package.

​
Quick Start

1

Keep the default

Do nothing. framework defaults to "praisonai", so every turn runs the built-in agent with no extra install.
2

Install the extras

Add the framework you want as an extra of praisonai-frameworks:
The other extras are autogen, langgraph, agno, google-adk, openai-agents, and pydantic-ai.
3

Set the setting

Open Settings → Models → Agent framework, type the framework name (for example crewai), and restart the app. The field is marked Requires restart, so the engine picks it up on the next launch.

​
How It Works

A non-default framework routes through praisonai.agents_generator.AgentsGenerator with a generated one-agent YAML — the chat turn is expressed as a single agent, single task config. Because that path returns the finished result rather than a token stream, streaming is not available for these frameworks: the reply arrives whole. The exact contract lives in run_with_framework and _framework_yaml in the engine’s server.py.

​
Availability & Install Hints

GET /frameworks reports this same list at runtime — available names what this install can run, and hints gives the install command for the rest.

​
Refusal Behaviour

A framework that is not installed is refused with its install command, not silently swapped for the built-in. Selecting crewai without the extra installed makes the turn raise a RuntimeError whose message names praisonai-frameworks and how to obtain it — the setting never quietly falls back to praisonai. A silent fallback is what makes a setting look effective while changing nothing, so the engine refuses instead.

​
Best Practices

The extras are heavy — each pulls its own dependency tree. Install only the framework you intend to use rather than every extra at once.
The framework field is requiresRestart: true. Relaunch the app after changing it so the engine loads the selected adapter.
The reply arrives whole for any framework other than praisonai. The streaming toggle has no effect on those turns — expect the answer to appear at once rather than token by token.

Settings Reference

The framework row and every other Models field

PraisonAI Agents

What the built-in framework does

CrewAI

Role-based multi-agent crews

LangGraph

Graph-structured agent workflows