Development Setup

Set up a PraisonAI development environment with uv

Set up a local PraisonAI development environment using uv — the fast Python package manager.

Quick Start

1. Install uv

   pip install uv

2. Clone and Install

   git clone https://github.com/MervinPraison/PraisonAI.git
   cd PraisonAI
   
   # Install base dependencies
   uv pip install -r pyproject.toml

3. Install with Extras

   # Single extra
   uv pip install -r pyproject.toml --extra code
   
   # Multiple extras
   uv pip install -r pyproject.toml --extra "crewai,autogen"

Available Extras

Bump and Release

# Bump version and prepare release
python src/praisonai/scripts/bump_and_release.py 2.2.99

# With praisonaiagents dependency update
python src/praisonai/scripts/bump_and_release.py 2.2.99 --agents 0.0.169

# Publish to PyPI
cd src/praisonai && uv publish

Project Structure

praisonai-package/
├── src/
│   ├── praisonai/           # Main user-facing CLI package (pip install praisonai)
│   ├── praisonai-code/      # Agentic terminal CLI — extracted from praisonai (incremental C0–C6)
│   ├── praisonai-agents/    # Agent SDK (praisonaiagents)
│   ├── praisonai-ts/        # TypeScript SDK
│   └── praisonai-rust/      # Rust SDK
├── examples/                # Example scripts
└── tests/                   # Test suites

praisonai-code Sibling Package

praisonai-code hosts the agentic terminal CLI (run, chat, code, warm runtime, CLI backends) as an internal sibling package. praisonai remains the user-facing install; praisonai-code is not published standalone to PyPI during migration.

Status: C0 scaffold merged in PraisonAI#2520. C1 moved runtime/ and cli_backends/ into praisonai_code in PraisonAI#2523; PEP 562 shims keep the old import paths working. See the praisonai-code migration guide for the full C0–C6 roadmap and shim behaviour.

Dependency Rules

praisonai (main)  →  depends on  praisonai-code
praisonai-code    →  depends on  praisonaiagents (core SDK)

Dev Install

1. Install the sibling package in editable mode

   pip install -e src/praisonai-code

2. Verify the install

   python -c "import praisonai_code; print(praisonai_code.__version__)"
   # → 0.0.1

Migration Plan (C0–C6)

Track upstream progress in the praisonai-code migration guide and PraisonAI#2512.

Related