dograh-hq/dograh

Open source voice AI platform. Self-hosted alternative to Vapi and Retell. On Prem, BYOK across Speech to Speech or LLM/STT/TTS, with a visual workflow builder, MCP native and telephony support.

📚 요약

Dograh AI는 음성 AI 에이전트를 구축하기 위한 오픈소스이자 셀프 호스팅 가능한 플랫폼입니다. 비주얼 워크플로우 에디터를 통해 전화 기반 대화형 봇을 생성, 테스트 및 실행할 수 있습니다. 스택은 모듈형으로 구성되어 있어 원하는 LLM, 음성 인식(STT), 음성 합성(TTS) 또는 전화 서비스 제공업체를 플러그인할 수 있으며, 제품에 포함된 기본 스택을 사용할 수도 있습니다. Docker 원커맨드 설정으로 몇 분 안에 전체 인스턴스를 실행할 수 있으며, 클라우드 호스팅 SaaS 버전도 제공됩니다.

🛠️ 핵심 기능

기능	설명
비주얼 워크플로우 빌더	노드(시작, 에이전트, 도구, QA, 지식 베이스, webhooks, 종료)를 드래그 앤 드롭하여 코딩 없이 통화 흐름을 설계합니다.
테스트 패널	Test Audio로 브라우저에서 봇과 대화하거나, Test Chat으로 텍스트 기반의 빠른 반복 및 대화 기록 재생이 가능합니다.
전화 통합	Twilio, Vonage, Telnyx, Plivo, Vobiz, Cloudonix, Asterisk ARI용 커넥터가 내장되어 있으며, 통화 전환을 통한 상담원 연결도 지원합니다.
플러그인 가능한 AI 스택	자체 LLM, STT, TTS를 사용하거나 Dograh의 기본 스택을 사용할 수 있으며, 키는 환경 변수로 설정 가능합니다.
MCP (Machine Coding Protocol) 지원	Claude Code, Codex, Cursor 등 MCP 클라이언트를 연결하여 프로그래밍 방식으로 워크플로우를 편집하고, 스키마를 가져오며, 자연어 프롬프트에서 에이전트를 생성할 수 있습니다.
SDKs	Python (`dograh-sdk`) 및 Node (`@dograh/sdk`) 라이브러리를 사용하여 프로그래밍 방식으로 에이전트를 생성하고 발신 통화를 수행할 수 있습니다.
원커맨드 Docker 배포	`curl … && ./start_docker.sh` 명령어로 `docker‑compose.yaml`을 가져와 전체 스택(API, UI, MinIO 스토리지, 선택적 Cloudflare tunnel)을 실행합니다.
셀프 호스팅 데이터	모든 데이터는 자체 인프라(MinIO 또는 S3 호환 스토리지)에 저장되어 데이터 주권을 완전히 제어할 수 있습니다.

🚀 시작하기 (퀵 스타트)

# Docker compose 파일 및 시작 스크립트 가져오기
curl -o docker-compose.yaml https://raw.githubusercontent.com/dograh-hq/dograh/main/docker-compose.yaml \
     -o start_docker.sh https://raw.githubusercontent.com/dograh-hq/dograh/main/scripts/start_docker.sh
chmod +x start_docker.sh
# 플랫폼 실행 (인바운드 webhook을 위한 공개 Cloudflare tunnel 생성)
./start_docker.sh

몇 분 후 http://localhost:3010에서 UI에 접속할 수 있습니다.
계정을 생성하고 비주얼 빌더를 사용하여 음성 봇을 정의하세요.
내장된 오디오 또는 채팅 테스터로 즉시 테스트할 수 있습니다.

📦 아키텍처 개요

프론트엔드 – 포트 3010에서 제공되는 React UI. 워크플로우 에디터와 테스트 도구를 제공합니다.
백엔드 – API 요청 처리, LLM 호출 오케스트레이션, STT/TTS 및 전화 webhook 라우팅을 수행하는 Python 서비스.
스토리지 – 녹음, 프롬프트, 봇 정의를 영구 저장하기 위한 MinIO(셀프 호스팅 S3 호환) 또는 외부 S3.
전화 게이트웨이 – 제공업체로부터의 수신/발신 통화 이벤트를 통합된 내부 형식으로 변환하는 커넥터.
MCP 서버 – 코딩 어시스턴트(Claude Code, Codex 등)가 워크플로우 JSON을 읽고 쓸 수 있도록 엔드포인트를 노출합니다.

🤝 커뮤니티 및 지원

Slack 커뮤니티 – 문제 해결, 기능 논의 및 온보딩을 위한 활발한 채널.
GitHub Discussions & Issues – 유스케이스 공유, 버그 보고 및 PR을 위한 공간.
문서 – 배포, MCP 통합 및 SDK 사용법을 다루는 전체 문서(https://docs.dograh.com).

📜 라이선스

BSD 2‑Clause – 상업적 사용, 수정 및 재배포를 허용하는 관대한 라이선스.

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 외부적인 가정은 추가되지 않았습니다.