Skip to main content
One command. Everything installed. Isolated from your system Python. You’re welcome. 🚀

​
One-Liner Install

curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
The installer automatically:
  • Detects your platform via uname
  • Picks a tool manager: uv tool → pipx → bootstrap uv if neither is present
  • Installs praisonai into an isolated environment
  • Drops a ~/.local/bin/praisonai shim and wires it onto your PATH
  • Prints a “Get started” panel pointing at praisonai setup, praisonai upgrade, and praisonai uninstall

​
What Gets Installed

ComponentDescription
praisonaiFull PraisonAI wrapper (pulls praisonai-code and praisonaiagents)
Isolation environmentuv tool or pipx-managed environment
~/.local/bin/praisonaiCLI shim on PATH
Shell rc PATH block~/.zshrc / ~/.bashrc (+ login profile) / ~/.config/fish/config.fish

​
Lighter Install Alternatives

The one-liner installer always installs the full praisonai package. For a smaller footprint, use pip directly: 
pip install praisonai-code

pip install praisonaiagents
praisonai-code gives you the agent runtime and full CLI (run, chat, code, …) without gateway or messaging-bot integrations. praisonaiagents is the pure Python SDK with no CLI at all — import it directly in your own application. See Installation for a full comparison.

​
Quick Start

After installation: 
from praisonaiagents import Agent

agent = Agent(name="assistant", instructions="Be helpful")
response = agent.start("Hello!")
print(response)
Set your API key first:
export OPENAI_API_KEY=your_key

​
Install Options

The installer’s only knobs are three environment variables. 
PRAISONAI_VERSION=0.14.0 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
Installs praisonai==0.14.0 instead of the latest release.
PRAISONAI_INSTALLER=pipx curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
Force uv or pipx. pipx errors if not installed; uv bootstraps itself when missing.
PRAISONAI_NONINTERACTIVE=1 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
Suitable for CI. The script never prompts regardless.

​
Environment Variables

VariableDefaultDescription
PRAISONAI_VERSIONlatestPin a specific version (appended as praisonai==VERSION)
PRAISONAI_INSTALLERautoForce uv or pipx
PRAISONAI_NONINTERACTIVEunsetNon-interactive/CI mode

​
Manage Your Install

After installing, keep the CLI current or remove it cleanly: 
praisonai upgrade          # update in place
praisonai upgrade --check  # is a newer version available?
praisonai uninstall        # remove cleanly

​
Next Steps

Build Your First Agent

Create an AI agent in 3 lines of code

Isolation Backends

Compare uv and pipx

Installer Internals

How install.sh works

Upgrade & Uninstall

Self-manage your CLI install