Hexabot
Hexabot v3 is an automation platform with first-class AI capabilities, combining workflows, actions, and conversational channels in one runtime.
Ask AI about Hexabot
Powered by Claude · Grounded in docs
I know everything about Hexabot. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Automate the Boring, Keep the Magic
Build and run agentic workflows across channels with YAML, tools, MCP, memory and RAG.
Website · Documentation · Extensions · Discord
Hexabot v3 is an automation platform with first-class AI capabilities, combining workflows, actions, and conversational channels in one runtime.
Quick Start
Prerequisites
- Node.js
^20.19.0 - One package manager (
npm,pnpm,yarn, orbun) - Docker (optional, for Docker-based services)
This Quick Start targets projects generated with the CLI.
If you are contributing to the Hexabot monorepo itself, use PNPM (see CONTRIBUTING.md).
1) Install the CLI
npm install -g @hexabot-ai/cli
Or run the CLI without a global install:
npx @hexabot-ai/cli --help
2) Create and run a project
hexabot create my-project
cd my-project
hexabot dev
No global install? Use npx equivalents:
npx @hexabot-ai/cli create my-project
cd my-project
npx @hexabot-ai/cli dev
hexabot create auto-detects your package manager. You can force one with --pm, for example:
hexabot create my-project --pm npm
hexabot create prompts for initial admin credentials and requires an interactive terminal (TTY). In CI/non-interactive shells, run it from a local terminal first.
Default local endpoints:
- Admin UI:
http://localhost:3000 - API:
http://localhost:3000/api - API docs (non-production):
http://localhost:3000/docs
Useful CLI commands:
hexabot create <project-name>hexabot dev [--docker --services <list>]hexabot start [--docker --services <list>]hexabot docker <up|down|logs|ps|start>hexabot env <init|list>hexabot checkhexabot config <show|set>hexabot migrate [args...]
For full CLI details, see packages/cli/README.md.
Core Capabilities
- Agentic workflows: YAML workflow definitions with typed runtime contracts.
- Action-based execution: actions define workflow behavior with schema-validated inputs/outputs/settings.
- Binding system: reusable capability/config bindings separated from task logic.
- Memory support: explicit memory definitions and runtime memory integration.
- MCP integration points: Model Context Protocol support for tool/context interoperability.
- Multi-channel continuity: channels and helpers remain core concepts.
- Schema-first architecture: broad use of Zod for validation and shared contracts.
Data Layer
- TypeORM is the standard backend data layer.
- SQLite is the default local option.
- Postgres is first-class for production setups.
- Configure DB runtime using
DB_TYPEandDB_*variables.
Contributing
If you want to contribute to the Hexabot monorepo (architecture, package map, PNPM workspace, Turbo tasks, CI checks), use CONTRIBUTING.md.
License
Copyright (c) 2025 Hexastack.
Licensed under FCL-1.0-ALv2. See LICENSE.md for full terms.
