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

​
One-Liner Install

curl -fsSL https://praison.ai/install.sh | bash
The installer automatically:
  • Detects your OS (macOS, Linux, Windows WSL)
  • Picks the best isolation backend: uv tool → pipx → venv fallback
  • Installs Python 3.10+ if needed (venv path only)
  • Creates an isolated environment for PraisonAI
  • Drops a ~/.local/bin/praisonai shim on your PATH
  • Offers shell tab-completions for bash, zsh, or fish

​
What Gets Installed

ComponentDescription
praisonai[all]Full PraisonAI package with all extras
Python 3.10+If not already installed (venv path only)
Isolation backenduv tool, pipx, or venv at ~/.praisonai/venv
~/.local/bin/praisonaiCLI shim on PATH (all backends)
Shell rc PATH block~/.zshrc / ~/.bashrc / ~/.config/fish/config.fish
The installer ends with an interactive onboarding prompt:
Set up a messaging bot (Telegram / Discord / Slack / WhatsApp) now? [Y/n]
  • Default is Yes — safe to accept on desktop installs
  • Skip with n or use --no-onboard / PRAISONAI_NO_ONBOARD=1
  • Auto-skipped in CI/headless environments (no TTY detected)

​
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

curl -fsSL https://praison.ai/install.sh | bash -s -- --backend pipx
curl -fsSL https://praison.ai/install.sh | bash -s -- --backend uv
curl -fsSL https://praison.ai/install.sh | bash -s -- --backend venv

curl -fsSL https://praison.ai/install.sh | bash -s -- --install-dir /opt/praisonai
Sets the base directory for the venv fallback (default: ~/.praisonai).
curl -fsSL https://praison.ai/install.sh | bash -s -- --no-modify-path
The installer still exports ~/.local/bin for the current session, but skips writing to your shell rc. Add it manually afterward.
curl -fsSL https://praison.ai/install.sh | bash -s -- --extras ui,chat

curl -fsSL https://praison.ai/install.sh | bash -s -- --version 0.14.0

curl -fsSL https://praison.ai/install.sh | bash -s -- --no-venv

curl -fsSL https://praison.ai/install.sh | bash -s -- --dry-run

​
Environment Variables

VariableDefaultDescription
PRAISONAI_VERSIONlatestVersion to install
PRAISONAI_EXTRAS""Comma-separated extras (defaults to all)
PRAISONAI_BACKENDautoForce backend: uv / pipx / venv / system / auto
PRAISONAI_INSTALL_DIR~/.praisonaiBase dir for the venv fallback
PRAISONAI_NO_MODIFY_PATH0Skip shell rc PATH modification (1 to enable)
PRAISONAI_SKIP_VENV0Skip isolation entirely (1 to enable)
PRAISONAI_PYTHONauto-detectPython executable path
PRAISONAI_DRY_RUN0Preview mode (1 to enable)
PRAISONAI_NO_ONBOARD0Skip onboarding (1 to enable)

​
Next Steps

Build Your First Agent

Create an AI agent in 3 lines of code

Isolation Backends

Compare uv, pipx, and venv

Installer Internals

How install.sh works

Add Tools

Give your agent superpowers