Default Framework Change (v1.0.0+)
Default framework changed from crewai to praisonai when running YAML files without an explicit framework flag
from praisonaiagents import Agent
agent = Agent(name="default-agent", instructions="Use the default agent framework.")
agent.start("What is the current default framework for this agent?")The default framework changed from crewai to praisonai when running YAML files without specifying an explicit framework.
from praisonai import PraisonAI
# No framework= argument — uses 'praisonai' by default
praison = PraisonAI(agent_file="agents.yaml")
result = praison.run()The user runs a YAML file without framework:; agents execute on the praisonai adapter by default.
Quick Start
- Before (v0.x)
Running
praisonai agents.yamlwould fail with error:ValueError: Unknown praisonai.framework_adapters plugin: ''. Available: ['ag2', 'autogen', 'autogen_v4', 'crewai', 'praisonai'] - After (v1.0.0+)
Running
praisonai agents.yamlworks out of the box using thepraisonaiframework:bash praisonai agents.yaml # ✅ Uses praisonai framework by default
Agent-Centric Example
from praisonai import PraisonAI
# No framework= argument — uses 'praisonai' by default
praison = PraisonAI(agent_file="agents.yaml")
result = praison.run()Equivalent CLI command:
praisonai agents.yamlBoth produce the same result with no --framework flag required.
Framework Precedence
PraisonAI resolves the framework in this order:
| Priority | Source | Example |
|---|---|---|
| 1 | CLI flag | --framework crewai |
| 2 | YAML key | framework: crewai |
| 3 | Registry default | FrameworkAdapterRegistry.resolve_or_default(None) → pick_default() → praisonai on a standard install |
The set of valid framework names is discovered dynamically from the adapter registry — see Framework Adapter Plugins.
How to Keep CrewAI as Default
If you want to continue using CrewAI as your default framework, you have two options:
Option 1: YAML Configuration
framework: crewai
topic: Your task description
roles:
# Your agents hereOption 2: CLI Flag
praisonai --framework crewai agents.yamlUser Interaction Flow
Best Practices
Pin framework in YAML for team consistency
Add framework: crewai (or your preferred adapter) to shared YAML so every teammate gets the same runtime without passing CLI flags.
Use –framework for one-off overrides
Keep YAML portable and pass --framework crewai only when experimenting with a different adapter.
Verify availability before CI runs
Run praisonai --list-frameworks in CI to confirm the expected adapter is installed before kicking off agent workflows.
Migrate gradually with explicit framework keys
During upgrades, set framework: praisonai explicitly in YAML so behaviour stays predictable even if defaults change again.