YAML, 도구(tools), MCP, 메모리(memory) 및 RAG를 사용하여 다양한 채널에서 에이전트 워크플로(agentic workflows)를 구축하고 실행하세요.

웹사이트 (Website)
·
문서 (Documentation)
·
확장 프로그램 (Extensions)
·
Discord

Hexabot v3는 워크플로(workflows), 액션(actions), 대화형 채널(conversational channels)을 하나의 런타임(runtime)에 결합한 일류 AI 기능을 갖춘 자동화 플랫폼입니다.

• Node.js
  ^20.19.0

• 하나의 패키지 매니저 (npm, pnpm, yarn 또는 bun) - Docker (선택 사항, Docker 기반 서비스를 위한 경우)

이 퀵 스타트(Quick Start)는 CLI로 생성된 프로젝트를 대상으로 합니다.

만약 Hexabot 모노레포(monorepo) 자체에 기여(contributing)하려는 경우, PNPM을 사용하세요 (CONTRIBUTING.md 참조).

npm install -g @hexabot-ai/cli

또는 전역 설치 없이 CLI를 실행하세요:

npx @hexabot-ai/cli --help

hexabot create my-project
cd my-project
hexabot dev

전역 설치를 하지 않았나요? npx를 사용하세요.

동일한 명령어:

npx @hexabot-ai/cli create my-project
cd my-project
npx @hexabot-ai/cli dev

hexabot create는 패키지 매니저를 자동으로 감지합니다. --pm을 사용하여 특정 매니저를 강제할 수 있습니다. 예시:

hexabot create my-project --pm npm

hexabot create는 초기 관리자 자격 증명(admin credentials)을 요청하며 대화형 터미널(TTY)이 필요합니다. CI 또는 비대화형 셸(non-interactive shells)에서는 먼저 로컬 터미널에서 실행하세요.

기본 로컬 엔드포인트(endpoints):

• 관리자 UI (Admin UI): http://localhost:3000
• API: http://localhost:3000/api
• API 문서 (비운영 환경): http://localhost:3000/docs

유용한 CLI 명령어:

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 check

hexabot config <show|set>

hexabot migrate [args...]

전체 CLI 상세 정보는 packages/cli/README.md를 참조하세요.

에이전트 워크플로 (Agentic workflows): 타입이 지정된 런타임 계약 (runtime contracts)을 포함하는 YAML 워크플로 정의.액션 기반 실행 (Action-based execution): 스키마로 검증된 입력/출력/설정을 통해 워크플로 동작을 정의하는 액션(actions).**바인딩 시스템 (Binding system):**태스크 로직과 분리되어 재사용 가능한 기능/설정 바인딩.**메모리 지원 (Memory support):**명시적인 메모리 정의 및 런타임 메모리 통합.**MCP 통합 지점 (MCP integration points):**도구/컨텍스트 상호 운용성을 위한 Model Context Protocol 지원.**멀티 채널 연속성 (Multi-channel continuity):**채널(channels)과 헬퍼(helpers)가 핵심 개념으로 유지됨.**스키마 우선 아키텍처 (Schema-first architecture):**검증 및 공유 계약을 위한 Zod의 폭넓은 사용.

TypeORM은 표준 백엔드 데이터 레이어입니다.SQLite는 기본 로컬 옵션입니다.Postgres는 프로덕션 설정을 위한 퍼스트 클래스(first-class) 옵션입니다. DB_TYPE 및 DB_* 변수를 사용하여 DB 런타임을 구성하세요.

Hexabot 모노레포(아키텍처, 패키지 맵, PNPM 워크스페이스, Turbo 태스크, CI 체크)에 기여하고 싶다면 CONTRIBUTING.md를 사용하세요.

Copyright (c) 2025 Hexastack.

FCL-1.0-ALv2에 따라 라이선스가 부여됩니다. 전체 약관은 LICENSE.md를 참조하세요.