Hexabot v3 – Open-Source AI Workflow Automation Platform
A practical guide to self-hosting Hexabot v3, the open-source AI automation platform with workflows, agents, MCP tools, and multi-channel support on your own VPS.
TL;DR
TL;DR: Hexabot v3 is an open-source AI workflow automation platform that combines YAML-defined workflows, LLM-powered agents, MCP tool integration, and multi-channel support — deployable on your own server with a single CLI command.
Source and Accuracy Notes
⚠️ This section is MANDATORY. All links must be verified from actual source, not guessed.
- Project page: hexabot.ai ← MUST visit and verify
- Source repository: github.com/Hexastack/Hexabot ← MUST read README
- License: NOASSERTION (verified via GitHub API; no standard SPDX license file found in repo — verify independently before commercial use)
- HN launch thread: news.ycombinator.com/item?id=41724497
- Latest release: v3.3.4 (verified via
git ls-remote --tags) - Source last checked: 2026-07-29
What Is Hexabot v3?
Hexabot v3 is an open-source automation platform that brings together AI agents, workflow definitions, and conversational channels under one roof. The project describes itself as:
“Automate the Boring, Keep the Magic — Build and run agentic workflows across channels with YAML, tools, MCP, memory and RAG.”
Key characteristics verified from the README and GitHub repository:
- License: Proprietary/NOASSERTION — not a standard open-source license. Commercial use requires separate agreement. Check hexabot.ai/license before deploying in production for clients.
- Language: TypeScript/Node.js monorepo
- Latest version: v3.3.4 (as of July 2026)
- Stars: 1,121 on GitHub
- Default ports: Admin UI and API at
http://localhost:3000
Setup Workflow
Prerequisites
- Node.js
^24.17.0 - One package manager:
npm,pnpm,yarn, orbun - Docker (optional, for Docker-based services)
- At least 2 GB RAM recommended
Step 1: Install the CLI
npm install -g @hexabot-ai/cli
Or run without a global install:
npx @hexabot-ai/cli --help
Step 2: Create and run a project
hexabot create my-project
cd my-project
hexabot dev
The CLI auto-detects your package manager. To force a specific one:
hexabot create my-project --pm npm
Default local endpoints after startup:
- Admin UI:
http://localhost:3000 - API:
http://localhost:3000/api - API docs (non-production):
http://localhost:3000/docs
Step 3: Deploy with Docker (production)
hexabot docker up
hexabot docker logs
hexabot docker ps
Useful Docker commands:
hexabot docker up --services <list>
hexabot docker down
hexabot docker start
Step 4: Configure environment
hexabot env init # Initialize environment variables
hexabot env list # Show current env vars
hexabot check # Validate configuration
hexabot config show # Display current config
hexabot config set # Update a config key
Deeper Analysis
Core Architecture
Hexabot v3 is structured around four pillars:
- Agentic Workflows — YAML workflow definitions with typed runtime contracts, letting you define automation logic declaratively
- Actions — Schema-validated input/output/settings blocks that power workflow behaviour
- Channels — Multi-channel support (web, Discord, WhatsApp, etc.) with session continuity
- MCP Integration — Model Context Protocol support for tool/context interoperability with external AI clients
Supported LLMs
The platform integrates with multiple LLM providers:
- Claude (Anthropic)
- GPT-4/GPT-4o (OpenAI)
- Gemini (Google)
- Mistral
- Llama (via Ollama)
- DeepSeek
- Custom endpoints via OpenAI-compatible API
Data Layer
- TypeORM as the standard backend ORM
- SQLite for local development (zero-config)
- PostgreSQL for production (first-class support)
Configure via DB_TYPE and DB_* environment variables.
MCP Integration
Hexabot v3 exposes MCP-compatible tool endpoints, allowing it to serve as a tool provider for external AI clients like Claude and Cursor. Tools are generated from the platform’s action system.
Practical Evaluation Checklist
- [ ] Node.js 24.17+ installed (
node --version) - [ ] CLI installed and
hexabot --helpworks - [ ] Project created with
hexabot create - [ ] Admin UI accessible at
localhost:3000 - [ ] Docker deployment works (
hexabot docker up) - [ ] API docs accessible at
localhost:3000/docs - [ ] Environment variables configured for production
- [ ] PostgreSQL configured for production use
- [ ] MCP endpoint reachable (if integrating with external AI)
Security Notes
- Change default admin credentials immediately after first run
- Use
hexabot checkto audit configuration before production exposure - PostgreSQL is recommended over SQLite for any internet-facing deployment
- The
NOASSERTIONlicense means you should verify commercial usage terms at hexabot.ai/license before building client projects - Run behind a reverse proxy (nginx/Caddy) with TLS in production
FAQ
Q: Is Hexabot free to use on a VPS? A: The repository is publicly available and the core platform is open-source. However, the license is “NOASSERTION” rather than a standard SPDX license (MIT, Apache 2, GPL), so commercial deployment should be verified against hexabot.ai’s current licensing terms.
Q: What is the minimum server spec? A: The README lists no explicit minimum. For light usage, a VPS with 2 GB RAM and a single CPU core should suffice. For production with multiple channels and LLM inference, 4 GB+ RAM is recommended.
Q: Can I use it without Docker?
A: Yes. The CLI-based workflow (hexabot dev / hexabot start) runs directly on Node.js. Docker is optional.
Q: Does it support MCP tools from other servers? A: Yes. Hexabot v3 has first-class MCP integration — it can both consume tools from external MCP servers and expose its own actions as MCP tools to other clients.
Q: How does it compare to n8n or Temporal? A: Unlike n8n, Hexabot is specifically designed around LLM-native agents and conversational channels rather than generic webhook/node automation. Unlike Temporal, it uses YAML-defined workflows rather than durable code execution. The MCP integration layer is also more explicit in Hexabot v3.
Conclusion
Hexabot v3 fills a specific niche: open-source AI workflow automation with first-class MCP support, multi-channel chat, and a developer-friendly CLI. Its YAML-based workflow definition makes it more accessible than Temporal for teams that want declarative automation without writing durable code. The self-hosted deployment path is straightforward — one CLI command gets you a running instance.
If you need a self-hosted alternative to platforms like Voiceflow or Manychat with LLM agents and MCP tool interoperability, Hexabot v3 is worth evaluating. Start with npx @hexabot-ai/cli create my-project on a test machine to get a feel for the workflow authoring experience before committing to a VPS deployment.
Project: hexabot.ai | Repo: github.com/Hexastack/Hexabot | v3.3.4 (July 2026)
Related Posts
ai-setup
Recall – Persistent Memory for Claude Code via MCP Hooks
Recall gives Claude Code a permanent memory store that survives session restarts and context compaction. Four hooks capture and restore context automatically — with cloud SaaS or self-hosted options.
2/28/2026
dev-tools
AgentMesh – Define AI Agent Teams in YAML
Define multi-agent AI workflows in YAML and run them locally with one command. AgentMesh brings Docker Compose patterns to AI agent orchestration.
5/28/2026
ai-setup
IonRouter – Fast Low-Cost AI Inference API
IonRouter is a YC W26 inference API routing open-source and fine-tuned models via an OpenAI-compatible endpoint, built on a C++ runtime optimized for GH200.
5/28/2026