Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.praison.ai/llms.txt

Use this file to discover all available pages before exploring further.

The PraisonAI Package Manager provides a pip-like interface with built-in security defaults to prevent dependency confusion attacks.

​
Quick Start

# Install a package
praisonai install requests

# Uninstall a package
praisonai uninstall requests

# List installed packages
praisonai package list

# Search for packages
praisonai package search langchain

​
Commands

​
install

Install Python packages from PyPI or custom index. 
praisonai install <package...> [options]
Options:
OptionDescription
--index-url <url>Use custom index URL
--extra-index-url <url>Add extra index (requires --allow-extra-index)
--allow-extra-indexAllow extra index URLs (security risk!)
--python <path>Python interpreter to use
-U, --upgradeUpgrade packages
--no-depsDon’t install dependencies
--jsonOutput in JSON format
Examples: 
# Install single package
praisonai install requests

# Install multiple packages
praisonai install requests httpx aiohttp

# Install with version constraint
praisonai install "requests>=2.28"

# Install specific version
praisonai install requests==2.31.0

# Upgrade existing package
praisonai install requests --upgrade

# Install without dependencies
praisonai install mypackage --no-deps

# Use custom index
praisonai install mypackage --index-url https://pypi.mycompany.com/simple

# JSON output
praisonai install requests --json

​
uninstall

Uninstall Python packages. 
praisonai uninstall <package...> [options]
Options:
OptionDescription
--python <path>Python interpreter to use
-y, --yesDon’t ask for confirmation
--jsonOutput in JSON format
Examples: 
# Uninstall package (with confirmation)
praisonai uninstall requests

# Uninstall without confirmation
praisonai uninstall requests --yes

# Uninstall multiple packages
praisonai uninstall requests httpx --yes

# JSON output
praisonai uninstall requests --json

​
package list

List installed packages. 
praisonai package list [options]
Options:
OptionDescription
--python <path>Python interpreter to use
--jsonOutput in JSON format
Examples: 
# List all packages
praisonai package list

# JSON output
praisonai package list --json

# Filter with jq
praisonai package list --json | jq '.packages[] | select(.name | contains("praison"))'
Search for packages on PyPI. 
praisonai package search <query> [options]
Options:
OptionDescription
--jsonOutput in JSON format
Examples: 
# Search for packages
praisonai package search langchain

# JSON output
praisonai package search langchain --json

​
package index

Manage package index configuration. 
praisonai package index <subcommand> [options]
Subcommands:
SubcommandDescription
showShow current index configuration
set <url>Set primary index URL
Examples: 
# Show current configuration
praisonai package index show

# JSON output
praisonai package index show --json

# Set custom index
praisonai package index set https://pypi.mycompany.com/simple

# Reset to PyPI default
praisonai package index set https://pypi.org/simple

​
Security Features

​
Dependency Confusion Prevention

By default, only the primary index (PyPI) is used. Extra indexes are blocked to prevent dependency confusion attacks. 
# This will FAIL (extra index not allowed by default)
praisonai install mypackage --extra-index-url https://other.index.com/simple

# Explicitly allow extra index (shows security warning)
praisonai install mypackage \
  --extra-index-url https://other.index.com/simple \
  --allow-extra-index

​
Security Warning

When using --allow-extra-index, you’ll see: 
⚠️  WARNING: Using extra index URLs can lead to dependency confusion attacks.
Only use this option if you trust the extra index and understand the risks.

​
Best Practices

  1. Prefer --index-url over --extra-index-url when possible
  2. Pin versions for production deployments
  3. Use private index for internal packages instead of extra indexes
  4. Audit dependencies regularly

​
Configuration

Configuration is stored in ~/.praisonai/config.toml: 
[package]
index_url = "https://pypi.org/simple"
extra_index_urls = []
allow_extra_index = false

​
Environment Variables

VariableDescription
PRAISONAI_PACKAGE_INDEX_URLOverride primary index URL
PIP_INDEX_URLFallback to pip’s index URL

​
Exit Codes

CodeMeaning
0Success
1General error
2Validation error
11Dependency error

​
JSON Output Format

​
install

{
  "ok": true,
  "packages": ["requests"],
  "message": "Successfully installed requests-2.31.0"
}

​
package list

{
  "ok": true,
  "packages": [
    {"name": "requests", "version": "2.31.0"},
    {"name": "httpx", "version": "0.25.0"}
  ]
}

​
package search

{
  "ok": true,
  "results": [
    {
      "name": "langchain",
      "version": "0.1.0",
      "summary": "Building applications with LLMs",
      "author": "LangChain",
      "home_page": "https://langchain.com"
    }
  ]
}

​
package index show

{
  "ok": true,
  "index_url": "https://pypi.org/simple",
  "extra_index_urls": [],
  "allow_extra_index": false
}

​
See Also