praisonai-code
Agentic terminal CLI for PraisonAI — the terminal-native agent product
(run, chat, code, warm runtime, CLI backends) extracted from the
praisonai wrapper.
Analogues: opencode, codex, gemini-cli.
Status
C0–C5 complete. C6 integration gate verified — see
src/praisonai/tests/C6_VERIFICATION.md.
| Step | Scope | Status |
|---|---|---|
| C0 | Scaffold | Done |
| C1 | runtime/ + cli_backends/ |
Done |
| C2 | interactive/, execution/, ui/, output/, state/ |
Done |
| C3 | Agentic commands | Done |
| C4 | Agentic features | Done |
| C5 | main.py, app.py, config/session/utils + shims |
Done |
| C6 | Integration gate + sign-off | Done |
| C7 | Hot-path standalone (agentic CLI without wrapper import) | Done |
praisonai_code.runtime— warm local runtime (daemon + thin client).praisonai_code.cli_backends— CLI backend implementations (e.g. Claude Code).praisonai_code.llm— endpoint resolution, credentials, model catalogue.praisonai_code.tool_resolver— YAML tool name resolution.
See src/praisonai/tests/C7_VERIFICATION.md for the hot-path sign-off checklist.
Dependency rules
praisonai (main) → depends on praisonai-code
praisonai-code → depends on praisonaiagents (core SDK)
praisonai-code also pulls in its own third-party runtime deps (rich, typer,
click, textual, PyYAML, python-dotenv, litellm, mcp, pydantic — see
pyproject.toml). The rules above govern the inter-package direction.
C7 (hot path complete): Standalone
pip install praisonai-codesupports core agentic terminal commands without importing the wrapper on the hot path. Approval backends resolve locally viapraisonai_code.cli.features._approval_bridge(channel bots delegate to the wrapper). Optional features (observability sinks, framework adapters, bots/gateway) remain wrapper-only viapraisonai_code._wrapper_bridge.
Standalone limits (pip install praisonai-code only)
The terminal-native commands (run, chat, code, doctor, daemon) live in
praisonai_code.cli.commands.* and resolve via LazyCommandGroup without
importing the wrapper. Only commands in _WRAPPER_RESIDENT_COMMANDS (see
praisonai_code/cli/app.py) require pip install praisonai.
| Command | Works standalone? | Notes |
|---|---|---|
praisonai-code --version |
Yes | |
run --help, config, doctor |
Yes | |
run --output actions "…" |
Yes | In-process Agent (structured events). run modes: silent (default), plain, actions, verbose, json, stream, stream-json |
run --output json/stream/stream-json "…" |
Yes | In-process Agent (structured output) |
run "…" (default) |
Needs praisonai |
Human-readable text run delegates to the wrapper's handle_direct_prompt; standalone gates with an install hint pointing to --output actions |
run --output plain/verbose/silent "…" |
Needs praisonai |
Same text path as default; standalone gates with an install hint |
chat --output plain "…" |
Yes | One-shot; interactive REPL also in code package. chat modes: actions (default), plain, verbose, json, silent |
code --help |
Yes | Full code assistant command registered |
daemon start (foreground) |
Yes | |
daemon start --background |
Yes | Spawns python -m praisonai_code.runtime |
batch, docs, langfuse, flow, n8n, train, … |
No | _WRAPPER_RESIDENT_COMMANDS — needs pip install praisonai |
bot, gateway, pairing, … |
No | Needs praisonai bot package |
Known limitations:
praisonai-code --helpmay crash on Windows (cp1252) due to emoji in command descriptions — tracked separately.- Piped stdin (
file | run) is not yet supported on Windows.
For bots, gateway, batch, observability sinks, and the wrapper-resident commands
above, install the full wrapper: pip install praisonai.
Completed C7 steps:
praisonai_code._registry— vendored plugin registry (no wrapper import)praisonai_code._version/runtime/descriptor.py— version frompraisonai-codepraisonai_code.__main__+praisonai-codeconsole script — standalone entrypraisonai_code._logging— CLI logging without wrapper dependencypraisonai_code.llm.*— env, credentials, catalogue, configpraisonai_code._framework_availability,_safe_loader,tool_resolver— execution helpers- Namespace cleanup —
praisonai_code.cli.features.*local imports on agentic path
Backward compatibility is preserved via PEP 562 shims at the old
praisonai.* import paths, so pip install praisonai and
from praisonai.cli.main import PraisonAI keep working unchanged.
Install
Recommended (includes wrapper + bots/gateway):
pip install praisonai
Standalone code package (agentic CLI only):
pip install praisonai-code
praisonai-code --version
python -m praisonai_code --help
Development / monorepo:
pip install -e src/praisonai-agents
pip install -e src/praisonai-code
pip install -e src/praisonai
python -c "import praisonai_code; print(praisonai_code.__version__)"
PyPI: Published as praisonai-code after praisonaiagents in the
three-package release order (see pypi-release.yml).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file praisonai_code-0.1.2.tar.gz.
File metadata
- Download URL: praisonai_code-0.1.2.tar.gz
- Upload date:
- Size: 903.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b45a1c1c22529ea0997737ddaeb766a9347a5c269bcf9667a9de1698f7083c4
|
|
| MD5 |
8be045dc56bf3fa5a54c3515c57745bf
|
|
| BLAKE2b-256 |
56afdbd5226a26486164edea1201506ba3455b147c40772ae1c6b4eac954210f
|
File details
Details for the file praisonai_code-0.1.2-py3-none-any.whl.
File metadata
- Download URL: praisonai_code-0.1.2-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8c44602b56599be1419d68c2fe060cbdff4f6ade8fcb9298bc1c2c52a4399042
|
|
| MD5 |
d4813d43907d60d757f172c1bc8ab4d9
|
|
| BLAKE2b-256 |
3affc3f7514984d6a6e9759b76a89e1eac291538658029301255244ec2f83f31
|
