bytechefhq/bytechef

드래그 앤 드롭 방식의 AI Agent (AI 에이전트) 컴포넌트가 모델 → 도구 선택 (tool selection) → 실행 (execution) → 관찰 (observation) → 다음 단계 (next step)로 이어지는 전체 에이전트 루프를 스트리밍 및 구조화된 출력 (structured output)과 함께 실행합니다.

ByteChef와 대화하며 AI 에이전트 및 워크플로 (workflows)를 구축하세요. Copilot이 문장으로부터 워크플로를 생성하고, 설정된 에이전트 단계를 배치하며, 실패한 실행에 대해 설명하고 수정 사항을 제안합니다.

요구 사항: Docker Desktop

이것은 ByteChef를 시작하는 가장 빠른 방법입니다. 저장소(repository)에서 docker-compose.yml 파일을 다운로드하세요:

curl -O https://raw.githubusercontent.com/bytechefhq/bytechef/master/docker-compose.yml
docker compose -f docker-compose.yml up

PostgreSQL 데이터베이스와 ByteChef 컨테이너가 모두 자동으로 시작됩니다.

http://localhost:8080/login 접속 → Create Account (계정 생성) → 로그인.

환경에서 Docker Compose를 지원하지 않는 경우, 다음 단계를 따르세요:

docker network create -d bridge bytechef_network

docker run --name postgres -d -p 5432:5432 \
--env POSTGRES_USER=postgres \
--env POSTGRES_PASSWORD=postgres \
...

docker run --name bytechef -it -p 8080:8080 \
--env BYTECHEF_DATASOURCE_URL=jdbc:postgresql://postgres:5432/bytechef \
--env BYTECHEF_DATASOURCE_USERNAME=postgres \
...

참고: 백그라운드 모드 (detached mode)로 실행하려면 -it 대신 -d 플래그를 사용하세요.

http://localhost:8080/login 접속 → Create Account (계정 생성) → 로그인.

New Project (새 프로젝트) → New Workflow (새 워크플로)

• 트리거 (trigger) 추가
• AI Agent (AI 에이전트) 컴포넌트 추가
• model (모델) 선택, 200개 이상의 커넥터 (connectors)에서 tools (도구) 연결, 선택적으로 knowledge base (지식 베이스) 및 guardrails (가드레일) 추가
• 필요한 자격 증명 (credentials) 입력
• 속성 패널에서 각 컴포넌트의 파라미터 (parameters) 구성
• 워크플로 테스트
• 배포 (Deploy)

하단에 JSON이 포함된 Visual editor (비주얼 에디터), Git 친화적인 Flow controls (흐름 제어)—condition (조건), switch (스위치), loop (루프), each (각 항목), parallel (병렬), branch (분기)

· 서브 워크플로우 (sub-workflows)
트리거 (Triggers)— 웹훅 (webhook) · 스케줄 (schedule) · 폴링 (polling) · 앱 이벤트 (app-event) · 수동 (manual) · 폼 (form)
다국어 코드 (Polyglot code)— Java · JavaScript · Python · Ruby on GraalVM
내구 실행 (Durable execution)— Atlas 런타임(runtime) 기반, Postgres 지원, 수평 확장을 위한 큐 모드 (memory · Redis · RabbitMQ · Kafka · JMS · AMQP · SQS)
API로서의 워크플로우 (Workflows-as-APIs)— 워크플로우가 인증된 HTTP 엔드포인트가 될 수 있음
Git 네이티브 (Git-native)— UI에서 푸시(push), 브랜치(branch)로 지원되는 환경(environments)

워크플로우 내부의 에이전트 (Agents inside workflows)— 에이전트는 하나의 단계(step)이며, 하위 분기(downstream branches)는 에이전트의 결정에 반응함
에이전트 도구로서의 워크플로우 (Workflows as agent tools)— 재시도(retries) 및 승인(approvals) 기능이 포함된 "주문 환불" 워크플로우는 하나의 도구가 됨
서브 에이전트 (Sub-agents)— 코디네이터 에이전트(coordinator agents)가 전문가 에이전트(specialist agents)를 호출함
인간 참여형 (Human-in-the-loop)— 승인을 위해 일시 중지, Slack/이메일로 라우팅, 응답 시 재개
단일 감사 로그 (One audit log)— 에이전트의 결정, 도구 호출, 워크플로우 실행, 인간의 승인이 모두 하나의 추적 경로(trail)에 기록됨

CRM · 마케팅 · 커뮤니케이션 · 이커머스 · 클라우드 스토리지 · 데이터베이스 · AI/ML · 헬프데스크 · 금융. 모든 커넥터(connector)는 또한 에이전트 도구(agent tool)이며, 또한 MCP 도구(MCP tool)입니다. 전체 카탈로그를 살펴보세요.

기능 (Capability)	CE (Apache 2.0)	EE
비주얼 에디터 (Visual editor), AI 에이전트, 워크플로우, 200개 이상의 커넥터	✅	✅
API로서의 워크플로우 (Workflows-as-APIs)	—	✅
Git 네이티브 (Git-native)	—	✅
마이크로서비스 배포 (Microservices deployment)	—	🚧 개발 중
AI 코파일럿 (AI Copilot)	—	✅
SSO / SAML / OIDC, SCIM, 고급 RBAC	—	🚧 개발 중
커넥션 범위 공유 (워크스페이스 / 프로젝트 / 조직)	—	🚧 개발 중
멀티 환경 프로모션, 상관 관계 ID(correlation IDs)가 포함된 감사 로그	—	✅
AI 게이트웨이 (AI Gateway) - 모델 라우팅, 할당량, 비용 제어	—	🚧 개발 중
임베디드 iPaaS (Embedded iPaaS) - SaaS 제품 내에 통합 및 AI 에이전트 탑재	—	✅

소프트웨어 기여를 원하신다면, 시작하기 위해 기여 가이드(contributing guide)를 읽어주세요.

이 프로젝트는 코어 부분( /ee/ 외부의 모든 것)에 대해서는 Apache 2.0 라이선스를 따르며, /ee/ 하위 코드(마이크로서비스, 임베디드, AI Copilot, SSO/SCIM, 고급 RBAC)에 대해서는 **ByteChef 엔터프라이즈 라이선스 (ByteChef Enterprise License)**를 따릅니다.

ByteChef는 Piper의 포크 (fork)로 시작되었습니다.