음성, LLM, 전송 서비스를 플러그인 방식으로 연결해 실시간 음성 및 멀티모달 AI 에이전트를 만드는 오픈소스 Python 프레임워크입니다.
livekit/agents
LiveKit 룸에서 서버 측 참가자로 실행되는 실시간 음성·영상 AI 에이전트 구축을 위한 Python 프레임워크입니다.
- 스타
- 14,887
- 포크
- 3,979
- 열린 이슈
- 802
- 마지막 커밋
- 4시간 전
어떤 프로젝트인가요?
Agents는 서버에서 실행되는 실시간 프로그래밍 가능 참가자를 구축하기 위한 Python 프레임워크입니다. 개발자는 이를 통해 LiveKit 룸에서 듣고, 보고, 응답하는 대화형 멀티모달 음성 에이전트를 만들고, 디스패치 API를 통해 최종 사용자를 에이전트에 연결할 수 있습니다.
이 프레임워크에서는 음성-텍스트 변환, LLM, 텍스트-음성 변환, 실시간 모델 제공업체를 하나의 파이프라인에 결합할 수 있습니다. 트랜스포머 모델을 기반으로 끼어들기를 줄이는 시맨틱 턴 감지, MCP 서버의 도구를 추가하는 기본 MCP 지원, RPC와 데이터 API를 통한 클라이언트와의 데이터 교환 기능도 제공합니다. 전화 통신 기능을 연동하면 에이전트가 전화를 걸거나 받을 수 있습니다.
Agents는 테스트를 위해 로컬 터미널에서 실행하거나, 핫 리로딩을 지원하는 개발 모드 또는 프로덕션 모드에서 실행할 수 있습니다. 프로젝트에는 판정자가 에이전트 동작을 확인할 수 있는 테스트 프레임워크도 내장되어 있습니다. Apache-2.0 라이선스로 제공되며, LiveKit 서버와 함께 자체 호스팅할 수 있습니다.
핵심 기능
- 01STT, LLM, TTS, 실시간 API 제공업체를 하나의 파이프라인에서 조합할 수 있습니다.
- 02트랜스포머 모델을 활용한 시맨틱 턴 감지로 끼어들기를 줄입니다.
- 03MCP 서버에서 도구를 불러오는 기본 MCP 지원을 제공합니다.
- 04전화를 걸고 받을 수 있도록 전화 통신 기능을 연동합니다.
- 05RPC와 데이터 API를 통해 클라이언트와 데이터를 교환합니다.
- 06판정자가 에이전트 동작을 확인할 수 있는 테스트 프레임워크가 내장되어 있습니다.
활용 사례
- 전화 통화에 응대하는 고객 지원 음성 에이전트 구축
- 자동으로 전화를 거는 아웃바운드 콜 에이전트 제작
- 룸의 모든 사용자를 위한 대화록을 생성하는 다중 사용자 전사 기능 추가
- 사용자의 실시간 영상에 반응하는 비전 지원 어시스턴트 개발
빠른 시작
- 1
모델 제공업체 플러그인과 함께 코어 라이브러리를 설치합니다
pip install "livekit-agents[openai,deepgram,cartesia]" - 2
LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET 환경 변수를 설정합니다
- 3
예제 에이전트를 myagent.py로 저장하고 터미널 모드에서 테스트합니다
python myagent.py console
사용 전 알아둘 점
- 빠른 시작 예제를 사용하려면 일반적으로 유료 서비스인 LiveKit Inference 또는 외부 모델 제공업체의 API 키가 필요합니다.
- 라이브 룸에 연결하려면 LiveKit Cloud 계정 또는 자체 호스팅 LiveKit 서버가 필요합니다.
토픽
자주 묻는 질문
- agents은(는) 무엇인가요?
- LiveKit 룸에서 서버 측 참가자로 실행되는 실시간 음성·영상 AI 에이전트 구축을 위한 Python 프레임워크입니다. Agents는 서버에서 실행되는 실시간 프로그래밍 가능 참가자를 구축하기 위한 Python 프레임워크입니다. 개발자는 이를 통해 LiveKit 룸에서 듣고, 보고, 응답하는 대화형 멀티모달 음성 에이전트를 만들고, 디스패치 API를 통해 최종 사용자를 에이전트에 연결할 수 있습니다.
- agents은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- agents은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- agents은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. agents의 마지막 커밋은 2026년 10월 22일입니다.
- agents은(는) 어디에 사용할 수 있나요?
- 전화 통화에 응대하는 고객 지원 음성 에이전트 구축 자동으로 전화를 거는 아웃바운드 콜 에이전트 제작 룸의 모든 사용자를 위한 대화록을 생성하는 다중 사용자 전사 기능 추가 사용자의 실시간 영상에 반응하는 비전 지원 어시스턴트 개발
- agents는 어떻게 설치하나요?
- 모델 제공업체 플러그인과 함께 코어 라이브러리를 설치합니다: pip install "livekit-agents[openai,deepgram,cartesia]" LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET 환경 변수를 설정합니다 예제 에이전트를 myagent.py로 저장하고 터미널 모드에서 테스트합니다: python myagent.py console
- agents은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/livekit/agents
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
실시간 멀티모달 대화형 음성 AI 에이전트를 위한 오픈소스 프레임워크로, 사전 구축된 에이전트 예제와 시각적 디자이너를 제공합니다.
음성 복제, 음성 생성, 앱 어디서나 음성 받아쓰기, AI 에이전트에 음성 부여를 지원하는 로컬 우선 오픈소스 AI 음성 스튜디오입니다.
클라우드 서비스나 완전 오프라인 온디바이스 모델을 지원하는 양방향 실시간 음성 번역 앱
전화 및 브라우저 음성 에이전트를 구축·테스트·배포할 수 있는 셀프 호스팅 가능한 오픈소스 음성 AI 플랫폼으로, 비주얼 워크플로 빌더와 MCP를 지원합니다.
음성을 듣고 GPT로 답변하며 ElevenLabs 음성과 Rhubarb 립싱크로 말하는 디지털 휴먼 아바타입니다.