praisonai-bot is the channel runtime package: messaging bots (Telegram, Discord, Slack, …), the WebSocket gateway control plane, and the praisonai-bot console script. Install it when you need gateway or bots without the full praisonai wrapper.
Four-tier ownership
| Package | Owns | Must not depend on |
|---|---|---|
praisonaiagents | Agent, tools, memory, hooks, bot/gateway protocols | praisonai, praisonai-code, praisonai-bot |
praisonai-code | Terminal CLI: run/chat/code, runtime, LLM | PyPI cycle on praisonai (lazy bridge only) |
praisonai-bot | Bots, gateway, channel CLI, OS daemon, gateway scheduler tick | PyPI cycle on praisonai (lazy bridge for jobs/UI) |
praisonai wrapper | Framework adapters, train, serve, dashboard, async jobs API | — |
praisonaiagents → praisonai-code + praisonai-bot → praisonai
Quick Start
Python API (bot-first imports)
Scheduler imports
Scheduled jobs (standalone)
The gateway scheduler tick lives inpraisonai-bot, so you can run scheduled agents without the full wrapper.
RunPolicy (the safety gate) is not shipped in praisonai-bot — install the praisonai wrapper if you need it. See Scheduled Run Policy.Console script
| Command | Purpose |
|---|---|
praisonai-bot gateway start | WebSocket gateway + health endpoint |
praisonai-bot bot start | Single-platform bot |
praisonai-bot onboard | Messaging onboarding wizard |
praisonai-bot pairing | DM pairing allowlist |
praisonai gateway, praisonai bot, etc.
What is not in this package
- Agentic hot path (
run,chat,code) — usepraisonai-codeorpraisonai - Framework adapters (CrewAI, AutoGen) — wrapper only
- Async jobs HTTP API (
praisonai.jobs) — wrapper only (UI bridge when co-installed) - Unified dashboard (
praisonai dashboard) — wrapper only RunPolicy(safety gate for unattended runs) — wrapper only (praisonai.scheduler.run_policy)
When to pick this vs other packages
| Use case | Install |
|---|---|
| Gateway + bots only, minimal deps | pip install "praisonai-bot[gateway,bot]" |
| Terminal agents without bots | pip install praisonai-code |
| Full stack (recommended default) | pip install praisonai |
| Embed agents in your app | pip install praisonaiagents |
Related
Installation Guide
Four-package comparison
Gateway CLI
Gateway operations
BotOS
Multi-platform bot orchestration
praisonai SDK
Full wrapper

