Overview & Architecture
CommB Assistant is an autonomous, open-source AI Commerce Agent and Multi-Agent Studio. Each CommB instance runs independently with its own database, vector search knowledge base, product catalog, and multi-channel webhooks (WhatsApp, Telegram, and Embeddable Website Widget).
Core Pillars:
- Zero Lock-in: Runs anywhere on Docker, Coolify, or bare metal.
- Data Privacy: Customer chats and transactions never leave your database.
- Centralized Releases: Instances connect to AgentOS in read-only mode to receive release notes and changelogs.
Quickstart with Docker Compose
Launch CommB and PostgreSQL with a single command:
git clone https://github.com/sannex-01/commb.git
cd commb
cp .env.example .env
docker compose up -dVisit http://localhost:8422/_/admin to complete the First-Run Administrator Setup wizard.
AI Agents Studio & Access Groups
Create and scope multiple specialized AI agents under your business (e.g. Sales Specialist, VIP Concierge, Billing Support). Assign specific Access Groups to restrict which products and knowledge base documents each agent can reference during conversations.
Sannex Agent SDK
Integrate with AgentOS and CommB programmatically using the official SDK:
Python (PyPI: commb-agent)
pip install commb-agent
Node.js (npm: @commb/agent)
npm install @commb/agent