한국어 | 繁體中文 | 日本語

₢ 킹

** Kokoro-82M Text-to-Speech의 올인원 도커 이미지 **

웹 UI • REST API • WebSocket • 스트리밍 • 배치 • MCP

---

✨ 특징

• ♂Beautiful Web UI - 실시간 오디오 재생과 현대 인터페이스
• java REST API - Swagger docs를 가진 완전한 기능의 HTTP 엔드포인트
• WebSocket - 실시간 양방향 TTS 통신
• 스트림 ** - Audio chunks는 생성자로 전달
• ☸ ** 배치 처리 ** - 하나의 요청에 여러 텍스트 처리
• LOG MCP Server - AI 에이전트 통합 (Claude 등)
• 다국어 ** - 영어, 중국어, 일본어, 스페인어, 프랑스어, 힌디어, 이탈리아어, 포르투갈어
• ♨ **GPU 가속 ** - 자동 메모리 관리와 CUDA 지원 -54+ Voices - 다양한 남성과 여성 목소리

⭐ 빠른 시작

브라우저에서 [T0]을 엽니다.

☸ 임명

# 필수품

• 도커 20.10+
• CUDA 지원이있는 NVIDIA GPU (옵션, CPU fallback 사용 가능)
• nvidia-docker2 ( GPU 지원 용)

Docker 실행

Docker 컴파일

설치 확인

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

| 변수 | 기본 | 설명 |

English | 简体中文 | 繁體中文 | 日本語

---

✨ Features

• 🎨 Beautiful Web UI - Modern interface with real-time audio playback
• 🔌 REST API - Full-featured HTTP endpoints with Swagger docs
• 📡 WebSocket - Real-time bidirectional TTS communication
• 🌊 Streaming - Audio chunks delivered as they generate
• 📦 Batch Processing - Process multiple texts in one request
• 🤖 MCP Server - AI agent integration (Claude, etc.)
• 🌍 Multi-language - English, Chinese, Japanese, Spanish, French, Hindi, Italian, Portuguese
• 🚀 GPU Accelerated - CUDA support with automatic memory management
• 📱 54+ Voices - Wide variety of male and female voices

🚀 Quick Start

docker run -d --name kokoro-tts --gpus all -p 8300:8300 neosun/kokoro-tts:latest

Open http://localhost:8300 in your browser.

📦 Installation

Prerequisites

• Docker 20.10+
• NVIDIA GPU with CUDA support (optional, CPU fallback available)
• nvidia-docker2 (for GPU support)

Docker Run

# With GPU
docker run -d \
  --name kokoro-tts \
  --gpus all \
  -p 8300:8300 \
  -e GPU_IDLE_TIMEOUT=600 \
  --restart unless-stopped \
  neosun/kokoro-tts:latest

# CPU only
docker run -d \
  --name kokoro-tts \
  -p 8300:8300 \
  --restart unless-stopped \
  neosun/kokoro-tts:latest

Docker Compose

services:
  kokoro-tts:
    image: neosun/kokoro-tts:latest
    container_name: kokoro-tts
    ports:
      - "8300:8300"
    environment:
      - GPU_IDLE_TIMEOUT=600
      - KEEP_MODEL_LOADED=true  # Never release model from memory
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]
    restart: unless-stopped

docker-compose up -d

Verify Installation

# Health check
curl http://localhost:8300/health

# Generate speech
curl -X POST http://localhost:8300/api/tts \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello world","voice":"af_heart"}' \
  -o output.wav

⚙️ Configuration