PraisonAI Code CLI

praisonai-code is the terminal-native agent CLI — install it on its own for a smaller footprint when you only need agentic commands.

# Standalone install — no wrapper needed
from praisonaiagents import Agent

Agent(instructions="Summarise this URL").start("https://arxiv.org/abs/2409.12345")

# Same result from the CLI, standalone (PR #2853)
pip install praisonai-code
praisonai-code run "Summarise https://arxiv.org/abs/2409.12345"

The user runs a terminal prompt; praisonai-code executes the agent in-process and prints the reply. Interactive chat and code also run from praisonai-code alone — no wrapper (PR #3818):

pip install praisonai-code
praisonai chat        # opens the split-pane async TUI, no wrapper required
praisonai code        # opens the resident code TUI, no wrapper required

As of PR #3818, chat and code interactive sessions now run resident inside praisonai-code — no wrapper required. pip install praisonai-code alone delivers a full interactive chat/code session on the split-pane TUI. Default run "…" and every --output text mode already ran in-process (PR #2853). When the praisonai wrapper is installed, it is still detected and the richer legacy interactive dispatch is used; the resident TUI is the fallback when the wrapper is absent.

Which install do I need?

Both praisonai-code (console script) and python -m praisonai_code call the same entry point: configure logging, register commands, then run the Typer app.

Interactive Chat & Code (resident TUI)

A single pip install praisonai-code is enough for an interactive session — the split-pane async TUI ships inside the package (PR #3818).

pip install praisonai-code
praisonai chat        # opens the split-pane async TUI, no wrapper required
praisonai code        # opens the resident code TUI, no wrapper required

Dimension	Resident TUI (`praisonai-code` alone)	Richer legacy dispatch (`+ praisonai`)
Install	`pip install praisonai-code`	`pip install praisonai`
Entry point	`praisonai_code.cli.interactive`	`PraisonAI._start_interactive_mode`
`code` command	Resident split-pane TUI	Preferred richer legacy dispatch
Wrapper-only helpers (`praisonai._async_bridge`, `praisonai.integration.context_files`)	Bridge fallback via `_wrapper_bridge`	Direct wrapper implementation

The wrapper is never required for the baseline TUI — it only upgrades code to the richer legacy dispatch and routes the wrapper-only helpers through their direct implementation instead of the _wrapper_bridge fallback.

Quick Start

Install standalone

pip install praisonai-code
praisonai-code version

The panel lists PraisonAI Code, PraisonAI Agents, and Python. When the full wrapper is installed, a PraisonAI Wrapper line appears as well.Use --version for a quick one-liner (package version only, no panel):

praisonai-code --version

Run your first agent:

praisonai-code run "Summarise the top 3 arXiv papers on RAG this week"

Every text mode — default run "…" and --output plain|verbose|silent|actions|json|stream|stream-json — runs standalone via the in-process Agent path. As of PR #3818, chat and code also open their resident interactive TUI standalone — the wrapper adds only the richer legacy dispatch for code and the gateway/bot channels.

Upgrade later if you need bots or gateway

pip install praisonai

The same praisonai-code binary keeps working. Wrapper-only commands (gateway, bot, onboard, pairing, identity, kanban, claw, dashboard) become available through the composed install.

How It Works

Text-mode run always executes in-process via the Agent path on a standalone install. When the wrapper is present, human-readable modes delegate to its handle_direct_prompt; when it is absent, they route through the in-process Agent with the matching output preset. chat and code open their resident TUI standalone (PR #3818); when the wrapper is installed, code prefers the richer legacy dispatch (PraisonAI._start_interactive_mode). Plugin discovery is vendored inside praisonai-code, so plugin-related flows keep working without the wrapper. Output presets map as plain → plain, silent/default → silent, verbose → verbose; silent-style presets print the final text. chat and code open their resident interactive TUI standalone (PR #3818) — pip install praisonai-code alone delivers full interactive sessions. When the praisonai wrapper is installed, code prefers its richer legacy dispatch (PraisonAI._start_interactive_mode):

pip install praisonai-code
praisonai-code chat
praisonai-code code "Refactor this function"

The vendored _registry module means plugins work even without the wrapper installed. Version resolution reads from the praisonai-code package metadata directly, not the wrapper.

Command matrix

Three tiers decide what a command needs: fully standalone, wrapper-boosted (works standalone but gains a richer path with the wrapper), and wrapper-only (not listed without the wrapper).

Standalone (`pip install praisonai-code`)	Wrapper-boosted (works standalone, richer with `praisonai`)	Wrapper-only (`pip install praisonai`)
acp · agent · agents · attach · auth · batch · benchmark · browser · call · `chat` · checkpoint · `code` · command · commit · completion · config · context · debug · deploy · diag · docs · doctor · endpoints · env · eval · examples · flow · github · hooks · init · knowledge · langextract · langfuse · loop · lsp · managed · mcp · memory · models · n8n · obs · package · paths · permissions · plugins · port · profile · publish · rag · realtime · recipe · registry · replay · research · `run "…"` (default) · `run --output plain/verbose/silent/actions/json/stream/stream-json` · rules · sandbox · schedule · serve · session · setup · skills · templates · test · todo · tools · traces · tracker · train · ui · up · validate · version · workflow	code (resident TUI standalone → richer legacy dispatch with wrapper)	bot · claw · daemon · dashboard · gateway · identity · kanban · onboard · pairing

chat and code open their resident TUI standalone (PR #3818); code prefers the richer legacy dispatch when the wrapper is installed. Wrapper-only names stay out of --help entirely and do not load a Typer module. The 14 stub groups below are a special mixed case — their legacy entry points are wrapper-required, but native subcommands stay standalone-safe:

Command	Standalone	Wrapper-required
Stub groups (`agents`, `workflow`, `registry`, `memory`, `skills`, `hooks`, `rules`, `eval`, `package`, `templates`, `todo`, `research`, `commit`, `call`) — delegating entry points	❌ Fail fast with hint	✅
Stub groups — native subcommands (`memory learn`, `skills bundle/check/eligible`, `eval list-judges`/`list`)	✅	✅

daemon start runs standalone in both foreground and --background modes — only the bot/gateway daemon sub-apps are wrapper-only.

Standalone limits

On a pip install praisonai-code-only install:

Command	Works standalone?	Notes
`run --help`, `config`, `doctor`	Yes
`run --output actions "…"`	Yes	In-process `Agent` (structured events preset)
`run --output json "…"`	Yes	In-process `Agent` (structured JSON output)
`run --output stream "…"`	Yes	In-process `Agent` (streaming text)
`run --output stream-json "…"`	Yes	In-process `Agent` (streaming JSON events)
`run "…"` (default)	Yes	In-process `Agent` (silent preset; prints final text)
`run --output plain/verbose/silent "…"`	Yes	In-process `Agent` (plain/verbose/silent presets)
`chat`, `code`	Yes	Run resident on the built-in split-pane TUI (PR #3818); the `praisonai` wrapper adds a richer dispatch mode for `code`
`daemon start` (foreground)	Yes
`daemon start --background`	Yes	Spawns `python -m praisonai_code.runtime`
Piped stdin (`type file.log \| praisonai-code run "…"`)	Yes	Works on Windows as of 2026-07-07 (PR #2705) via a stat-based pipe classifier; also supports `Get-Content file.log \| praisonai-code run "…"`. Interactive terminals skip the stdin read. See Piped Input.

chat, code, and every run output mode work on a praisonai-code-only install (PR #2853, PR #3818). Installing the wrapper (pip install praisonai) adds the richer legacy dispatch for code, the gateway, and channel bots — it is no longer required for the baseline interactive experience. praisonai-code doctor returns exit 0 on a healthy standalone install — wrapper-presence checks (performance_praisonai_import, acp_module, praisonai_package_structure, console_script_execution) SKIP rather than FAIL (PR #2851).

Stub command groups on standalone

Run agents standalone without the wrapper — the SDK works directly:

from praisonaiagents import Agent

Agent(instructions="Summarise this URL").start("https://arxiv.org/abs/2409.12345")

# Same result from the CLI, standalone (in-process)
pip install praisonai-code
praisonai-code run --output actions "Summarise https://arxiv.org/abs/2409.12345"

Fourteen command groups — agents, workflow, registry, memory, skills, hooks, rules, eval, package, templates, todo, research, commit, and call — delegate to the praisonai wrapper for their legacy entry points. On a standalone pip install praisonai-code (PR #2854) those entry points exit 1 with a single-line install hint — no Rich traceback:

agents requires the full wrapper. Install the full wrapper: pip install praisonai

The <group> name changes per command (workflow requires the full wrapper. …, registry requires the full wrapper. …, and so on).

These groups are mixed, not wholly wrapper-only. Their native subcommands keep working standalone — only the legacy delegating entry points fail fast.

Group	Standalone-safe native subcommand(s)
`memory`	`memory learn` (status/show/add/search/clear)
`skills`	`skills bundle`, `skills check`, `skills eligible`
`eval`	`eval list-judges`, `eval list` (alias — PR #2848)

Run pip install praisonai to unlock the wrapper-delegating entry points, or use the native standalone-safe subcommand.

Wrapper-command loading

Wrapper-only commands (bot, gateway, pairing, identity, onboard, kanban, dashboard, claw, daemon) are Typer sub-apps whose implementations live in the praisonai wrapper. When you install praisonai-code standalone, these commands are not listed in --help and are not resolvable — get_command() returns None instead of loading a module that doesn’t exist in praisonai_code.

# Standalone install, wrapper-only command
$ pip install praisonai-code
$ praisonai-code bot --help
Error: No such command 'bot'.

To use bot, gateway, pairing, identity, onboard, kanban, dashboard, claw, or daemon, install the full wrapper:

pip install praisonai

Configuration and environment

Variable / command	Behaviour
`LOGLEVEL`	Read on CLI entry via `configure_cli_logging` (default `WARNING`). Controls root log verbosity for standalone runs.
`praisonai-code version check`	Compares your installed version with PyPI (`https://pypi.org/pypi/praisonai-code/json`).

Version commands

praisonai-code version

Shows the full version panel:

PraisonAI Code: 0.0.4
PraisonAI Wrapper: 1.x.x   ← only shown when praisonai is installed
PraisonAI Agents: 1.6.x
Python: 3.12.x

praisonai-code version --json

Returns structured JSON:

{
  "praisonai-code": "0.0.4",
  "praisonai": "1.x.x",
  "praisonaiagents": "1.6.x",
  "python": "3.12.x"
}

The praisonai key is omitted when the wrapper is not installed.

praisonai-code version check

Queries PyPI and returns update status:

{
  "current": "0.0.4",
  "latest": "0.0.5",
  "update_available": true
}

praisonai-code version check needs outbound HTTPS to PyPI.

Best Practices

When to use praisonai-code alone

Use praisonai-code for any run "…" prompt (default or any --output mode), interactive chat/code (resident TUI, PR #3818), config, doctor, or the warm-runtime daemon — smaller install, no gateway/bot deps.

When to install the full wrapper

Install praisonai for the richer legacy code dispatch (PraisonAI._start_interactive_mode), Telegram/Discord/Slack bots, the WebSocket gateway, kanban/dashboard, and RunPolicy for unattended runs. Baseline interactive chat/code run standalone (PR #3818).

Monorepo dev install order

In dev, pip install -e src/praisonai-agents && pip install -e src/praisonai-code && pip install -e src/praisonai (this exact order) — matches the release publish order in pypi-release.yml.

AgentApp is a silent alias for AgentOS

from praisonai import AgentOS and from praisonai import AgentApp both work — AgentApp is a backward-compat silent alias for AgentOS. No deprecation warning is emitted.

Choose your install

Compare full wrapper, code-only, and SDK installs

Architecture

Six-package layout and dependency direction

Getting Started

Install

Core Concepts

Guides

Features

Models

Databases

Observability

Memory

Telemetry & Analytics

Knowledge

RAG

Persistence

Tools

Other Features

Developers

Configuration

Best Practices

Getting Started (No Code)

PraisonAI Code CLI

Which install do I need?

Interactive Chat & Code (resident TUI)

Quick Start

How It Works

Command matrix

Standalone limits

Stub command groups on standalone

Wrapper-command loading

Configuration and environment

Version commands

Best Practices

Choose your install

Architecture

​Which install do I need?

​Interactive Chat & Code (resident TUI)

​Quick Start

​How It Works

​Command matrix

​Standalone limits

​Stub command groups on standalone

​Wrapper-command loading

​Configuration and environment

​Version commands

​Best Practices

​Related

Choose your install

Architecture

Which install do I need?

Interactive Chat & Code (resident TUI)

Quick Start

How It Works

Command matrix

Standalone limits

Stub command groups on standalone

Wrapper-command loading

Configuration and environment

Version commands

Best Practices

Related