ten / docs /readmes /README-KR.md
3v324v23's picture
ะ—ะฐั„ะธะบัะธั€ะพะฒะฐะฝะฐ ั€ะฐะฑะพั‡ะฐั ะฒะตั€ัะธั TEN-Agent ะดะปั HuggingFace Space
87337b1

TEN Agent ๋ฐฐ๋„ˆ


๐ŸŽ‰ OpenAI ์‹ค์‹œ๊ฐ„ API์™€ RTC๋ฅผ ํƒ‘์žฌํ•œ TEN Agent

agent.theten.ai์—์„œ OpenAI ์‹ค์‹œ๊ฐ„ API, ๋‚ ์”จ ํ™•์ธ, ์›น ๊ฒ€์ƒ‰์„ ์ฒดํ—˜ํ•ด๋ณด์„ธ์š”.

OpenAI ์‹ค์‹œ๊ฐ„ API์˜ ์ดˆ์ €์ง€์—ฐ๊ณผ RTC์˜ AI ๋…ธ์ด์ฆˆ ์ œ๊ฑฐ๋ฅผ ๊ฒฐํ•ฉํ•˜์—ฌ ๋ถ€๋“œ๋Ÿฝ๊ณ  ๊ณ ํ’ˆ์งˆ์˜ ์ƒํ˜ธ์ž‘์šฉ์„ ๋ณด์žฅํ•ฉ๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์— ๋‚ ์”จ์™€ ๋‰ด์Šค ๋„๊ตฌ์˜ ์›ํ™œํ•œ ํ†ตํ•ฉ์œผ๋กœ TEN Agent๋Š” ๋”์šฑ ๋‹ค์žฌ๋‹ค๋Šฅํ•ด์กŒ์Šต๋‹ˆ๋‹ค.

OpenAI ์‹ค์‹œ๊ฐ„ API์™€ RTC๋ฅผ ํƒ‘์žฌํ•œ TEN Agent


TEN Agent ์‚ฌ์šฉ ์‚ฌ๋ก€

์‚ฌ์šฉ ์‚ฌ๋ก€


๋ฐ”๋กœ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ํ™•์žฅ ๊ธฐ๋Šฅ

๋ฐ”๋กœ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ํ™•์žฅ ๊ธฐ๋Šฅ


๋กœ์ปฌ ํ™˜๊ฒฝ์—์„œ์˜ TEN Agent ํ”Œ๋ ˆ์ด๊ทธ๋ผ์šด๋“œ

์‚ฌ์ „ ์š”๊ตฌ์‚ฌํ•ญ

์นดํ…Œ๊ณ ๋ฆฌ ์š”๊ตฌ์‚ฌํ•ญ
ํ‚ค โ€ข Agora ์•ฑ ID ์™€ ์•ฑ ์ธ์ฆ์„œ (๋งค์›” ๋ฌด๋ฃŒ ์‚ฌ์šฉ ์‹œ๊ฐ„ ์ œ๊ณต)
โ€ข OpenAI API ํ‚ค
โ€ข Deepgram ASR (๊ฐ€์ž… ์‹œ ๋ฌด๋ฃŒ ํฌ๋ ˆ๋”ง ์ œ๊ณต)
โ€ข FishAudio TTS (๊ฐ€์ž… ์‹œ ๋ฌด๋ฃŒ ํฌ๋ ˆ๋”ง ์ œ๊ณต)
์„ค์น˜ โ€ข Docker / Docker Compose
โ€ข Node.js(LTS) v18
์ตœ์†Œ ์‹œ์Šคํ…œ ์š”๊ตฌ์‚ฌํ•ญ โ€ข CPU >= 2์ฝ”์–ด
โ€ข RAM >= 4 GB

macOS: Apple Silicon์—์„œ์˜ Docker ์„ค์ •

Apple Silicon Mac์˜ ๊ฒฝ์šฐ, Docker ์„ค์ •์—์„œ "Use Rosetta for x86/amd64 emulation" ์ฒดํฌ๋ฅผ ํ•ด์ œํ•˜์„ธ์š”. ์ฐธ๊ณ : ARM์—์„œ ๋นŒ๋“œ ์‹œ๊ฐ„์ด ๋” ๋А๋ ค์งˆ ์ˆ˜ ์žˆ์ง€๋งŒ, x64 ์„œ๋ฒ„์— ๋ฐฐํฌํ–ˆ์„ ๋•Œ์˜ ์„ฑ๋Šฅ์€ ์ •์ƒ์ ์ž…๋‹ˆ๋‹ค.

Docker ์„ค์ •


๋‹ค์Œ ๋‹จ๊ณ„

1. .env ํŒŒ์ผ ์ƒ์„ฑ

cp ./.env.example ./.env

2. .env์—์„œ Agora ์•ฑ ID์™€ ์•ฑ ์ธ์ฆ์„œ ์„ค์ •

AGORA_APP_ID=
AGORA_APP_CERTIFICATE=

3. ์—์ด์ „ํŠธ ๊ฐœ๋ฐœ ์ปจํ…Œ์ด๋„ˆ ์‹œ์ž‘

docker compose up -d

4. ์ปจํ…Œ์ด๋„ˆ ์ง„์ž…

docker exec -it ten_agent_dev bash

5. ์—์ด์ „ํŠธ ๋นŒ๋“œ

task use

6. ์›น ์„œ๋ฒ„ ์‹œ์ž‘

task run

7. ํ”Œ๋ ˆ์ด๊ทธ๋ผ์šด๋“œ ์„ค์ • ํŽธ์ง‘

localhost:3000์—์„œ ํ”Œ๋ ˆ์ด๊ทธ๋ผ์šด๋“œ๋ฅผ ์—ด์–ด ์—์ด์ „ํŠธ๋ฅผ ๊ตฌ์„ฑํ•˜์„ธ์š”.

  1. ๊ทธ๋ž˜ํ”„ ์œ ํ˜• ์„ ํƒ (์˜ˆ: ์Œ์„ฑ ์—์ด์ „ํŠธ, ์‹ค์‹œ๊ฐ„ ์—์ด์ „ํŠธ)
  2. ํ•ด๋‹นํ•˜๋Š” ๋ชจ๋“ˆ ์„ ํƒ
  3. ํ™•์žฅ ๊ธฐ๋Šฅ์„ ์„ ํƒํ•˜๊ณ  API ํ‚ค ์„ค์ • ๊ตฌ์„ฑ

๋ชจ๋“ˆ ์˜ˆ์‹œ


TEN Agent ๊ตฌ์„ฑ ์š”์†Œ

๊ตฌ์„ฑ ์š”์†Œ ๋‹ค์ด์–ด๊ทธ๋žจ


์ตœ์‹  ์†Œ์‹ ๋ฐ›์•„๋ณด๊ธฐ

์‹œ์ž‘ํ•˜๊ธฐ ์ „์—, ์ €์žฅ์†Œ์— ์Šคํƒ€๋ฅผ ๋ˆŒ๋Ÿฌ ๋ชจ๋“  ์ƒˆ๋กœ์šด ๋ฆด๋ฆฌ์Šค์˜ ์•Œ๋ฆผ์„ ๋ฐ›์•„๋ณด์„ธ์š”!

TEN ์Šคํƒ€ ๋ˆ„๋ฅด๊ธฐ GIF


์ปค๋ฎค๋‹ˆํ‹ฐ ์ฐธ์—ฌ

  • Discord: ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๊ณต์œ ์™€ ์ปค๋ฎค๋‹ˆํ‹ฐ ์ฐธ์—ฌ์— ์ด์ƒ์ ์ž…๋‹ˆ๋‹ค.
  • GitHub Discussion: ํ”ผ๋“œ๋ฐฑ ์ œ๊ณต๊ณผ ์งˆ๋ฌธํ•˜๊ธฐ์— ์™„๋ฒฝํ•ฉ๋‹ˆ๋‹ค.
  • GitHub Issues: ๋ฒ„๊ทธ ์‹ ๊ณ ์™€ ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ์ œ์•ˆ์— ์ตœ์ ์ž…๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ ๊ธฐ์—ฌ ๊ฐ€์ด๋“œ๋ผ์ธ์„ ์ฐธ์กฐํ•˜์„ธ์š”.
  • X: ์—์ด์ „ํŠธ ๊ณต์œ ์™€ ์ปค๋ฎค๋‹ˆํ‹ฐ ์ƒํ˜ธ์ž‘์šฉ์— ์ข‹์Šต๋‹ˆ๋‹ค.

์ฝ”๋“œ ๊ธฐ์—ฌ์ž

TEN


๊ธฐ์—ฌ ๊ฐ€์ด๋“œ๋ผ์ธ

๊ธฐ์—ฌ๋ฅผ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค! ๋จผ์ € ๊ธฐ์—ฌ ๊ฐ€์ด๋“œ๋ผ์ธ์„ ์ฝ์–ด์ฃผ์„ธ์š”.


๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” Apache 2.0 ๋ผ์ด์„ ์Šค ํ•˜์— ์ œ๊ณต๋ฉ๋‹ˆ๋‹ค - ์ž์„ธํ•œ ๋‚ด์šฉ์€ LICENSE ํŒŒ์ผ์„ ์ฐธ์กฐํ•˜์„ธ์š”.