<h1><div align="center"> <img alt="pipecat" width="300px" height="auto" src="https://raw.githubusercontent.com/pipecat-ai/pipecat/main/pipecat.png"> </div></h1>

🎙️ Pipecat: 실시간 음성 및 멀티모달 (Multimodal) AI 에이전트

Pipecat은 실시간 음성 및 멀티모달 (Multimodal) 대화형 에이전트를 구축하기 위한 오픈 소스 Python 프레임워크입니다. 오디오와 비디오, AI 서비스, 다양한 전송 방식 (Transports), 그리고 대화 파이프라인 (Conversation pipelines)을 손쉽게 오케스트레이션 (Orchestrate)할 수 있어, 여러분은 에이전트만의 고유한 특징을 만드는 데 집중할 수 있습니다.

바로 시작하고 싶으신가요? pipecat init quickstart를 실행하거나 퀵스타트 가이드 (quickstart guide)를 따르세요.

🚀 구축 가능한 것들

• 음성 비서 (Voice Assistants) – AI와의 자연스러운 스트리밍 대화
• AI 컴패니언 (AI Companions) – 코치, 회의 보조자, 캐릭터
• 멀티모달 인터페이스 (Multimodal Interfaces) – 음성, 비디오, 이미지 등
• 대화형 스토리텔링 (Interactive Storytelling) – 생성형 미디어를 활용한 창의적인 도구
• 비즈니스 에이전트 (Business Agents) – 고객 접수, 지원 봇, 안내 흐름
• 복잡한 대화 시스템 (Complex Dialog Systems) – 구조화된 대화를 통한 로직 설계

🧠 왜 Pipecat인가?

• 음성 우선 (Voice-first): 음성 인식 (Speech recognition), 텍스트 음성 변환 (Text-to-speech), 대화 처리를 통합합니다.
• 플러그인 가능 (Pluggable): 다양한 AI 서비스와 도구를 지원합니다.
• 조립 가능한 파이프라인 (Composable Pipelines): 모듈형 구성 요소를 사용하여 복잡한 동작을 구축합니다.
• 실시간 (Real-Time): 다양한 전송 방식 (예: WebSockets 또는 WebRTC)을 통해 초저지연 상호작용을 제공합니다.

🌐 Pipecat 생태계

🧩 멀티 에이전트 시스템 (Multi-agent systems)

여러 AI 에이전트가 함께 작동해야 하나요? Pipecat Subagents를 사용하면 각 에이전트가 자체 파이프라인을 실행하고 공유 메시지 버스 (Message bus)를 통해 통신하는 분산형 멀티 에이전트 시스템을 구축할 수 있습니다. 전문가 간의 대화를 인계하고, 백그라운드 작업을 할당하며, 프로세스 또는 머신 전반에 걸쳐 에이전트를 확장하세요.

📱 클라이언트 SDK (Client SDKs)

클라이언트 애플리케이션을 구축 중이신가요? 공식 SDK를 사용하여 어떤 플랫폼에서든 Pipecat에 연결할 수 있습니다:

<a href="https://docs.pipecat.ai/client/js/introduction">JavaScript</a> | <a href="https://docs.pipecat.ai/client/react/introduction">React</a> | <a href="https://docs.pipecat.ai/client/react-native/introduction">React Native</a> |
<a href="https://docs.pipecat.ai/client/ios/introduction">Swift</a> | <a href="https://docs.pipecat.ai/client/android/introduction">Kotlin</a> | <a href="https://docs.pipecat.ai/client/c++/introduction">C++</a> | <a href="https://github.com/pipecat-ai/pipecat-esp32">ESP32</a>

🧭 구조화된 대화 (Structured conversations)

구조화된 대화를 구축하고 싶으신가요? 복잡한 대화 상태 (Conversational states)와 전환 (Transitions)을 관리하려면 Pipecat Flows를 확인해 보세요.

🪄 아름다운 UI (Beautiful UIs)

아름답고 매력적인 경험을 구축하고 싶으신가요? 음성 AI 애플리케이션을 빠르게 구축하기 위한 컴포넌트, 훅 (Hooks), 템플릿 모음인 Voice UI Kit을 확인해 보세요.

🛠️ 프로젝트 생성 및 배포 (Create and deploy projects)

Pipecat CLI를 사용하면 1분 안에 새로운 프로젝트를 생성할 수 있습니다. 그런 다음 CLI를 사용하여 에이전트를 모니터링하고 프로덕션 환경에 배포하세요.

🔍 디버깅 (Debugging)

파이프라인 (Pipeline)과 프로세서 (Processors)를 디버깅하는 데 도움이 필요하신가요? 실시간 Pipecat 디버거인 Whisker를 확인해 보세요.

🖥️ 터미널 (Terminal)

터미널 애플리케이션을 좋아하시나요? Pipecat을 위한 터미널 대시보드인 Tail을 확인해 보세요.

🤖 Claude Code 기술 (Claude Code Skills)

Claude Code와 함께 Pipecat Skills를 사용하여 프로젝트의 스캐폴딩 (Scaffold)을 수행하고, Pipecat Cloud에 배포하는 등의 작업을 수행하세요. 다음 명령어로 마켓플레이스를 설치할 수 있습니다:

claude plugin marketplace add pipecat-ai/skills

그 후 사용 가능한 플러그인을 설치하세요.

🧩 커뮤니티 통합 (Community Integrations)

자신만의 Pipecat 서비스 통합(service integrations)을 구축하고 공유하세요! 기존의 커뮤니티 통합 (community integrations)을 살펴보거나, 자신만의 통합 기능을 만들기 위해 가이드 (guide)를 확인해 보세요.

📺️ Pipecat TV 채널

저희 Pipecat TV 채널에서 새로운 기능, 인터뷰, 그리고 사용 방법(how-tos)을 만나보세요.

🎬 실제 작동 모습

<p float="left"> <a href="https://github.com/pipecat-ai/pipecat-examples/tree/main/simple-chatbot"><img src="https://raw.githubusercontent.com/pipecat-ai/pipecat-examples/main/simple-chatbot/image.png" width="400" /></a>&nbsp; <a href="https://github.com/pipecat-ai/pipecat-examples/tree/main/storytelling-chatbot"><img src="https://raw.githubusercontent.com/pipecat-ai/pipecat-examples/main/storytelling-chatbot/image.png" width="400" /></a> <br/> <a href="https://github.com/pipecat-ai/pipecat-examples/tree/main/daily-multi-translation"><img src="https://raw.githubusercontent.com/pipecat-ai/pipecat-examples/main/daily-multi-translation/image.png" width="400" /></a>&nbsp; <a href="https://github.com/pipecat-ai/pipecat/blob/main/examples/vision/vision-moondream.py"><img src="https://github.com/pipecat-ai/pipecat/blob/main/examples/assets/moondream.png" width="400" /></a> </p>

🧩 사용 가능한 서비스 (Available services)

| 카테고리 (Category) | 서비스 (Services) |

|

| Speech-to-Text | AssemblyAI, AWS, Azure, Cartesia, Deepgram, ElevenLabs, Fal Wizper, [Gladia](https://docs.pipecat.ai/api-reference/server/services

| ... |
📚 전체 서비스 문서 보기 →

⚡ 시작하기

로컬 머신에서 Pipecat을 실행하여 시작할 수 있으며, 준비가 되면 에이전트 프로세스를 클라우드(Cloud)로 이전할 수 있습니다.

1. uv 설치

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   도움이 필요하신가요? uv 설치 문서를 참조하세요.