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)
| Command | Works standalone? | Notes |
|---|---|---|
run --help, config, doctor |
Yes | |
run --output actions "…" |
Yes | In-process Agent |
run "…" (default) |
No | Requires pip install praisonai |
chat, code |
No | TUI / interactive legacy live in wrapper |
daemon start (foreground) |
Yes | |
daemon start --background |
Yes | Spawns python -m praisonai_code.runtime |
For full terminal UX (chat, code, default run), install the 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.0.23.tar.gz.
File metadata
- Download URL: praisonai_code-0.0.23.tar.gz
- Upload date:
- Size: 712.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.8.22
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eca3bdfedd67fc91af301a57fa7bf7c0b8b1a84bf49213cead76e5de899af423
|
|
| MD5 |
70bbee7bd904f7090bcaca3aca2939b3
|
|
| BLAKE2b-256 |
5b02cce429ddf538781b42c845957eccdf0c8d05e0e2d7f5b686d59952e7a561
|
File details
Details for the file praisonai_code-0.0.23-py3-none-any.whl.
File metadata
- Download URL: praisonai_code-0.0.23-py3-none-any.whl
- Upload date:
- Size: 861.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.8.22
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
04137d477dd9ecdbd0e90efc05b99063028f76bd9f92ac2f727522ab798468f5
|
|
| MD5 |
a45f72fa740f0e65f21bb85625efd9c3
|
|
| BLAKE2b-256 |
7c7d82ac09e3fad8123d492d7231c6912519b1b9720031797e634bb827cf1542
|
