Skip to content

Latest commit

 

History

History
495 lines (306 loc) · 21.6 KB

File metadata and controls

495 lines (306 loc) · 21.6 KB

목차

목차


👋 TEN에 오신 것을 환영합니다

TEN은 실시간 멀티모달 대화형 음성 에이전트를 구축하기 위한 오픈소스 프로젝트 모음입니다. TEN Framework, TEN Turn Detection, TEN Agent, TMAN Designer, TEN Portal을 포함하며, 이들은 모두 완전한 오픈소스입니다. TEN VAD는 아직 완전한 오픈소스는 아니지만, 공개적으로 사용 가능합니다.


커뮤니티 채널 목적
Follow on X X에서 TEN Framework를 팔로우하여 업데이트와 공지사항 확인
Follow on LinkedIn LinkedIn에서 TEN Framework를 팔로우하여 업데이트와 공지사항 확인
Discord TEN Community Discord 커뮤니티에 참여하여 개발자들과 연결
Hugging Face Space Hugging Face 커뮤니티에 참여하여 스페이스와 모델 탐색
WeChat 중국어 커뮤니티 토론을 위해 WeChat 그룹 참여

Important

TEN 저장소에 스타를 눌러주세요 ⭐️

새로운 릴리스와 업데이트에 대한 즉각적인 알림을 받을 수 있습니다. 여러분의 지원이 TEN의 성장과 개선을 도와줍니다!


TEN star us gif


Star History


🎨 TMAN Designer

TMAN Designer

TMAN Designer

TMAN Designer is a low/no-code option to create voice agents with an easy-to-use workflow UI. It can load apps and graphs, and includes an online editor, log viewer, and much more.

Check out this blog for more details.


✨ 기능

TEN Agent with Trulience

1️⃣ 실시간 아바타

TEN Agent를 사용하여 Trulience의 다양한 무료 아바타 옵션으로 매력적인 AI 아바타를 구축할 수 있습니다. 실행하기 위해서는 단 2단계만 필요합니다:

  1. README에 따라 Playground 설정 및 실행 완료
  2. Trulience에서 받은 아바타 ID와 토큰 입력


TEN Agent with MCP servers

2️⃣ MCP 서버를 통한 실시간 음성

TEN Agent는 이제 MCP 서버와 원활하게 통합되어 LLM 기능을 확장합니다. 시작하려면:

  1. Playground에서 Module Picker 열기
  2. LLM 통합을 위한 MCP 서버 도구 추가
  3. 확장 기능에 MCP 서버의 URL 붙여넣기
  4. TEN Agent와 실시간 대화 시작

이 통합을 통해 TEN Agent의 강력한 대화 능력을 유지하면서 MCP의 다양한 서버 기능을 활용할 수 있습니다.


esp32.mov

3️⃣ 하드웨어와의 실시간 통신

TEN Agent는 현재 Espressif ESP32-S3 Korvo V3 개발 보드에서 실행되고 있으며, 하드웨어에서 LLM과의 실시간 통신을 통합하는 훌륭한 방법을 제공합니다.

자세한 내용은 통합 가이드를 참조하세요.


Real-time vision

4️⃣ 실시간 비전 및 화면 공유 감지

Google Gemini Multimodal Live API를 사용하여 실시간 비전과 화면 공유 감지 기능을 경험해보세요. 이는 바로 사용할 수 있는 확장 기능으로, Weather Check와 Web Search와 같은 강력한 도구들이 TEN Agent에 완벽하게 통합되어 있습니다.


TEN with other LLM platforms

5️⃣ 다른 LLM 플랫폼과의 통합

TEN Agent + Dify

TEN은 다른 LLM 플랫폼에서도 실시간 인터랙티브 경험을 더욱 향상시키는 훌륭한 지원을 제공합니다. 자세한 내용은 문서를 참조하세요.


Image

6️⃣ StoryTeller - TEN 이미지 생성

StoryTeller를 사용한 실시간 이미지 생성을 경험해보세요. 이는 바로 사용할 수 있는 확장 기능으로, Weather Check와 Web Search와 같은 강력한 도구들이 TEN에 완벽하게 통합되어 있습니다.


🛝 TEN Agent Playground로 빠르게 시작하기

🅰️ localhost에서 Playground 실행

단계 ⓵ - 필수 요구사항

카테고리 요구사항
• Agora App IDApp Certificate (매월 무료 사용량 제공)
OpenAI API 키 (OpenAI와 호환되는 모든 LLM)
Deepgram ASR (가입 시 무료 크레딧 제공)
Elevenlabs TTS (가입 시 무료 크레딧 제공)
설치 Docker / Docker Compose
Node.js(LTS) v18
최소 시스템 요구사항 • CPU >= 2코어
• RAM >= 4 GB

Note

macOS: Apple Silicon에서의 Docker 설정

Docker 설정에서 "Use Rosetta for x86/amd64 emulation" 옵션의 체크를 해제하세요. ARM에서의 빌드 시간은 더 오래 걸릴 수 있지만, x64 서버에 배포할 때의 성능은 정상적입니다.


단계 ⓶ - VM에서 에이전트 빌드

1. 저장소를 클론하고 ai-agents로 이동한 후 .env.example에서 .env 파일 생성
cd ai_agent
cp ./.env.example ./.env
2. .env에 Agora App ID와 App Certificate 설정
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
3. 에이전트 개발 컨테이너 시작
docker compose up -d
4. 컨테이너 접속
docker exec -it ten_agent_dev bash
5. 기본 graph로 에이전트 빌드 (약 5분~8분 소요)

다른 예제는 /examples 폴더를 확인하세요

# 기본 에이전트 사용
task use

# 또는 데모 에이전트 사용
task use AGENT=agents/examples/demo
6. 웹 서버 시작
task run

단계 ⓷ - TMAN Designer로 에이전트 커스터마이징

Customize your agent with TMAN Designer

  1. localhost:49483 열기
  2. 메뉴에서 해당하는 그래프 로드 (예: Voice Assistant)
  3. 각 확장 기능의 API 키 입력 및 설정
  4. Voice Assistant 선택 후 localhost:3000을 열어 변경사항 확인


🅱️ Codespace에서 Playground 실행 (Docker 불필요)

GitHub는 각 저장소에 무료 Codespace를 제공하며, Docker 없이도 Playground를 실행할 수 있습니다. 또한 Codespace의 속도는 localhost보다 훨씬 빠릅니다.

자세한 내용은 이 가이드를 참조하세요.


🛳️ TEN Agent 자체 호스팅

🅰️ 🐳 Docker로 배포

에이전트를 커스터마이징한 후(TMAN Manager, Playground 또는 property.json 직접 편집), 릴리스용 Docker 이미지를 생성하여 서비스를 배포할 수 있습니다.

배포에 대한 자세한 내용은 배포 가이드를 참조하세요.


🅱️ 다른 클라우드 서비스로 배포

준비 중


🌏 TEN Framework 생태계

프로젝트 미리보기
🏚️ TEN Framework
TEN은 실시간 멀티모달 대화형 AI를 위한 오픈소스 프레임워크입니다.

️🔂 TEN Turn Detection
TEN은 전이중 대화 통신을 위한 것입니다.

🔉 TEN VAD
TEN VAD는 저지연, 경량, 고성능 스트리밍 음성 활동 감지기(VAD)입니다.

🎙️ TEN Agent
TEN Agent는 TEN Framework의 데모입니다.

🎨 TMAN Designer
TMAN Designer는 사용하기 쉬운 워크플로우 UI로 음성 에이전트를 만들기 위한 low/no-code 옵션입니다.

📒 TEN Portal
TEN framework의 공식 사이트로, 문서와 블로그가 있습니다.



❓ 질문하기

Ask DeepWiki

대부분의 질문은 DeepWiki를 사용하여 답변할 수 있습니다. 빠르고 직관적으로 사용할 수 있으며 여러 언어를 지원합니다.

🥰 기여하기

모든 형태의 오픈소스 협업을 환영합니다! 버그 수정, 기능 추가, 문서 개선, 아이디어 공유 등 여러분의 기여가 개인화된 AI 도구의 발전을 돕습니다. GitHub Issues와 Projects를 확인하여 기여 방법을 찾고 여러분의 기술을 보여주세요. 함께 멋진 것을 만들어봅시다!


Tip

모든 종류의 기여를 환영합니다 🙏

TEN을 더 좋게 만드는 데 참여하세요! 코드부터 문서까지 모든 기여가 중요합니다. TEN Agent 프로젝트를 소셜 미디어에 공유하여 다른 사람들에게 영감을 주세요!

프로젝트 업데이트, 토론, 협업 기회에 대해 TEN의 메인테이너 @elliotchen100 (𝕏) 또는 @cyfyifanchen (GitHub)에게 연락하세요.


코드 기여자

TEN

기여 가이드라인

기여를 환영합니다! 먼저 기여 가이드라인을 읽어주세요.

라이선스

  1. TEN framework 전체(아래에 명시적으로 나열된 폴더 제외)는 Apache License, Version 2.0으로 릴리스되며 추가 제한사항이 있습니다. 자세한 내용은 TEN framework의 루트 디렉토리에 있는 LICENSE 파일을 참조하세요.

  2. packages 디렉토리 내의 컴포넌트는 Apache License, Version 2.0으로 릴리스됩니다. 자세한 내용은 각 패키지의 루트 디렉토리에 있는 LICENSE 파일을 참조하세요.

  3. TEN framework에서 사용하는 서드파티 라이브러리는 자세히 나열되어 설명되어 있습니다. 자세한 내용은 third_party 폴더를 참조하세요.