https://github.com/hexabot-ai/hexabot
Hexabot v3 is an AI automation platform, combining workflows, actions, agents, and conversational channels in one runtime.
https://github.com/hexabot-ai/hexabot
agent agentic agents ai ai-automation artificial-intelligence automation bot-framework chatbot chatgpt claude-ai conversational-ai deepseek framework gemini llama llm mistral ollama workflow
Last synced: 1 day ago
JSON representation
Hexabot v3 is an AI automation platform, combining workflows, actions, agents, and conversational channels in one runtime.
- Host: GitHub
- URL: https://github.com/hexabot-ai/hexabot
- Owner: hexabot-ai
- License: other
- Created: 2024-09-09T18:57:42.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-06-19T16:25:40.000Z (9 days ago)
- Last Synced: 2026-06-19T18:15:05.259Z (9 days ago)
- Topics: agent, agentic, agents, ai, ai-automation, artificial-intelligence, automation, bot-framework, chatbot, chatgpt, claude-ai, conversational-ai, deepseek, framework, gemini, llama, llm, mistral, ollama, workflow
- Language: TypeScript
- Homepage: https://docs.hexabot.ai
- Size: 51.9 MB
- Stars: 974
- Watchers: 6
- Forks: 218
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-ChatGPT-repositories - Hexabot - Hexabot v3 is an AI automation platform, combining workflows, actions, agents, and conversational channels in one runtime. (Chatbots / Usage)
README
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 `^24.17.0`
- One package manager (`npm`, `pnpm`, `yarn`, or `bun`)
- 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](./CONTRIBUTING.md)).
### 1) Install the CLI
```bash
npm install -g @hexabot-ai/cli
```
Or run the CLI without a global install:
```bash
npx @hexabot-ai/cli --help
```
### 2) Create and run a project
```bash
hexabot create my-project
cd my-project
hexabot dev
```
No global install? Use `npx` equivalents:
```bash
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:
```bash
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 `
- `hexabot dev [--docker --services ]`
- `hexabot start [--docker --services ]`
- `hexabot docker `
- `hexabot env `
- `hexabot check`
- `hexabot config `
- `hexabot migrate [args...]`
For full CLI details, see [packages/cli/README.md](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_TYPE` and `DB_*` variables.
## Contributing
If you want to contribute to the Hexabot monorepo (architecture, package map, PNPM workspace, Turbo tasks, CI checks), use [CONTRIBUTING.md](./CONTRIBUTING.md).
## License
Copyright (c) 2025 Hexastack.
Licensed under **FCL-1.0-ALv2**. See [LICENSE.md](./LICENSE.md) for full terms.