Scripts & Automation

​

Script Overview

​

One-Liner Installer

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

iwr -useb https://praison.ai/install.ps1 | iex

​

Features

• OS Detection - Automatically detects macOS, Linux (various distros), Windows, WSL
• Isolation Backend - Auto-selects uv tool → pipx → venv fallback; override with --backend
• Python Management - Installs Python 3.10+ if not available (venv path only)
• Package Manager Support - brew, apt, dnf, pacman, winget, chocolatey
• PATH Shim - Drops ~/.local/bin/praisonai so the CLI is available without activating a venv
• Idempotent PATH Block - Appends a clearly-marked # >>> PraisonAI PATH >>> block to shell rc; skip with --no-modify-path
• Shell Completions - Offers to install bash/zsh/fish completions via praisonai completion <shell>
• Interactive Onboarding - Prompts for LLM setup and bot configuration after installation
• Dry Run Mode - Preview changes before applying

​

Environment Variables

​

Examples

# Basic install (isolated: uv tool -> pipx -> venv)
curl -fsSL https://praison.ai/install.sh | bash

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

# Install with extras
PRAISONAI_EXTRAS=ui,chat curl -fsSL https://praison.ai/install.sh | bash

# Don't touch shell rc
curl -fsSL https://praison.ai/install.sh | bash -s -- --no-modify-path

# Dry run (preview only)
PRAISONAI_DRY_RUN=1 curl -fsSL https://praison.ai/install.sh | bash

# Non-interactive for CI/CD
curl -fsSL https://praison.ai/install.sh | bash -s -- --no-prompt

​

Version Management

​

bump_version.py

cd src/praisonai
python scripts/bump_version.py 2.3.0

• praisonai/version.py
• pyproject.toml

​

check_version_sync.py

python src/praisonai/scripts/check_version_sync.py

​

Release Workflow

​

bump_and_release.py

python src/praisonai/scripts/bump_and_release.py

1. Bumps version
2. Updates changelog
3. Creates git tag
4. Pushes to GitHub
5. Triggers PyPI release

​

release.py

python src/praisonai/scripts/release.py

​

Smoke Testing

​

test-install-smoke.sh

cd src/praisonai/scripts
./test-install-smoke.sh

• Ubuntu 22.04
• Debian 12
• Alpine Linux

​

Docker Test Files

​

Adding New Scripts

1. Location: Place in src/praisonai/scripts/
2. Permissions: Make executable with chmod +x script.sh
3. Documentation: Update this page
4. Testing: Add to CI/CD if applicable

# Make script executable
chmod +x src/praisonai/scripts/my-script.sh

# Test locally
./src/praisonai/scripts/my-script.sh

​

Related