![TEN Agent 배너](https://github.com/TEN-framework/docs/blob/main/assets/jpg/banner.jpg?raw=true)

<div align="center">

[![X에서 팔로우](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=TenFramework)
[![토론 게시물](https://img.shields.io/github/discussions/TEN-framework/ten-agent?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/TEN-framework/ten-agent/discussions/)
[![커밋](https://img.shields.io/github/commit-activity/m/TEN-framework/ten-agent?labelColor=%20%237d89b0&color=%20%235d6b98)](https://github.com/TEN-framework/ten-agent/graphs/commit-activity)
[![해결된 이슈](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Ften-agent%20is%3Aclosed&label=issues%20closed&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues)
[![PR 환영](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls)
[![GitHub 라이선스](https://img.shields.io/badge/License-Apache_2.0-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ten-agent/blob/main/LICENSE)

[![Discord TEN 커뮤니티](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ)

<a href="https://trendshift.io/repositories/11978" target="_blank"><img src="https://trendshift.io/api/badge/repositories/11978" alt="TEN-framework%2FTEN-Agent | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

[![GitHub 워처](https://img.shields.io/github/watchers/TEN-framework/ten-agent?style=social&label=Watch)](https://GitHub.com/TEN-framework/ten-agent/watchers/?WT.mc_id=academic-105485-koreyst)
[![GitHub 포크](https://img.shields.io/github/forks/TEN-framework/ten-agent?style=social&label=Fork)](https://GitHub.com/TEN-framework/ten-agent/network/?WT.mc_id=academic-105485-koreyst)
[![GitHub 스타](https://img.shields.io/github/stars/TEN-framework/ten-agent?style=social&label=Star)](https://GitHub.com/TEN-framework/ten-agent/stargazers/?WT.mc_id=academic-105485-koreyst)

<a href="https://github.com/TEN-framework/ten-agent/blob/main/README.md"><img alt="영어 README" src="https://img.shields.io/badge/English-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-CN.md"><img alt="简体中文操作指南" src="https://img.shields.io/badge/简体中文-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-JP.md"><img alt="日本語のREADME" src="https://img.shields.io/badge/日本語-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-KR.md"><img alt="한국어 README" src="https://img.shields.io/badge/한국어-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-ES.md"><img alt="스페인어 README" src="https://img.shields.io/badge/Español-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-FR.md"><img alt="프랑스어 README" src="https://img.shields.io/badge/Français-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-IT.md"><img alt="이탈리아어 README" src="https://img.shields.io/badge/Italiano-lightgrey"></a>

[시작하기](https://doc.theten.ai/ten-agent/getting_started)
<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
[확장 기능 만들기](https://doc.theten.ai/ten-agent/create_a_hello_world_extension)
<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
[TEN Framework 저장소](https://github.com/TEN-framework/ten_framework)

</div>

<br>
<h2>🎉 OpenAI 실시간 API와 RTC를 탑재한 TEN Agent</h2>

[agent.theten.ai](https://agent.theten.ai)에서 OpenAI 실시간 API, **날씨 확인**, **웹 검색**을 체험해보세요.

OpenAI 실시간 API의 초저지연과 RTC의 AI 노이즈 제거를 결합하여 부드럽고 고품질의 상호작용을 보장합니다. 여기에 날씨와 뉴스 도구의 원활한 통합으로 TEN Agent는 더욱 다재다능해졌습니다.

![OpenAI 실시간 API와 RTC를 탑재한 TEN Agent](https://github.com/TEN-framework/docs/blob/main/assets/gif/weather-and-news.gif?raw=true)

<br>
<h2>TEN Agent 사용 사례</h2>

![사용 사례](https://github.com/TEN-framework/docs/blob/main/assets/jpg/usecases.jpg?raw=true)

<br>
<h2>바로 사용 가능한 확장 기능</h2>

![바로 사용 가능한 확장 기능](https://github.com/TEN-framework/docs/blob/main/assets/jpg/extensions.jpg?raw=true)

<br>
<h2>로컬 환경에서의 TEN Agent 플레이그라운드</h2>

### 사전 요구사항

| 카테고리 | 요구사항 |
|----------|-------------|
| **키** | • Agora [ 앱 ID ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) 와 [ 앱 인증서 ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project)(매월 무료 사용 시간 제공) <br>• [OpenAI](https://openai.com/index/openai-api/) API 키<br>• [ Deepgram ](https://deepgram.com/) ASR (가입 시 무료 크레딧 제공)<br>• [ FishAudio ](https://fish.audio/) TTS (가입 시 무료 크레딧 제공)|
| **설치** | • [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/)<br>• [Node.js(LTS) v18](https://nodejs.org/en) |
| **최소 시스템 요구사항** | • CPU >= 2코어<br>• RAM >= 4 GB |

<br>

### macOS: Apple Silicon에서의 Docker 설정

Apple Silicon Mac의 경우, Docker 설정에서 "Use Rosetta for x86/amd64 emulation" 체크를 해제하세요. 참고: ARM에서 빌드 시간이 더 느려질 수 있지만, x64 서버에 배포했을 때의 성능은 정상적입니다.

![Docker 설정](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true)

<br>

### 다음 단계

#### 1. `.env` 파일 생성

```bash
cp ./.env.example ./.env
```

#### 2. `.env`에서 Agora 앱 ID와 앱 인증서 설정

```bash
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
```

#### 3. 에이전트 개발 컨테이너 시작
```bash
docker compose up -d
```

#### 4. 컨테이너 진입
```bash
docker exec -it ten_agent_dev bash
```

#### 5. 에이전트 빌드
```bash
task use
```

#### 6. 웹 서버 시작
```bash
task run
```

#### 7. 플레이그라운드 설정 편집
[localhost:3000](http://localhost:3000)에서 플레이그라운드를 열어 에이전트를 구성하세요.
 1. 그래프 유형 선택 (예: 음성 에이전트, 실시간 에이전트)
 2. 해당하는 모듈 선택
 3. 확장 기능을 선택하고 API 키 설정 구성

![모듈 예시](https://github.com/TEN-framework/docs/blob/main/assets/gif/module-example.gif?raw=true)

<br>
<h2>TEN Agent 구성 요소</h2>

![구성 요소 다이어그램](https://github.com/TEN-framework/docs/blob/main/assets/jpg/diagram.jpg?raw=true)

<br>
<h2>최신 소식 받아보기</h2>

시작하기 전에, 저장소에 스타를 눌러 모든 새로운 릴리스의 알림을 받아보세요!

![TEN 스타 누르기 GIF](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true)

<br>

<h2>커뮤니티 참여</h2>

- [Discord](https://discord.gg/VnPftUzAMJ): 애플리케이션 공유와 커뮤니티 참여에 이상적입니다.
- [GitHub Discussion](https://github.com/TEN-framework/ten-agent/discussions): 피드백 제공과 질문하기에 완벽합니다.
- [GitHub Issues](https://github.com/TEN-framework/ten-agent/issues): 버그 신고와 새로운 기능 제안에 최적입니다. 자세한 내용은 [기여 가이드라인](./docs/code-of-conduct/contributing.md)을 참조하세요.
- [X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5): 에이전트 공유와 커뮤니티 상호작용에 좋습니다.

<br>
<h2>코드 기여자</h2>

[![TEN](https://contrib.rocks/image?repo=TEN-framework/ten-agent)](https://github.com/TEN-framework/ten-agent/graphs/contributors)

<br>
<h2>기여 가이드라인</h2>

기여를 환영합니다! 먼저 [기여 가이드라인](./docs/code-of-conduct/contributing.md)을 읽어주세요.

<br>
<h2>라이선스</h2>

이 프로젝트는 Apache 2.0 라이선스 하에 제공됩니다 - 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.