<p align="center"> <img src="https://raw.githubusercontent.com/izwi-ai/izwi/HE

Izwi는 음성 AI를 위한 데스크톱 앱, 웹 UI, CLI 및 로컬 추론 서버입니다.
이는 사용자의 기기에서 실행되며 클라우드 서비스나 API 키가 필요 없이 제품 워크플로우와 OpenAI 호환(OpenAI-compatible) API 경로를 모두 노출합니다.

기능 (What It Does)

• 로컬 ASR, 채팅 및 TTS 모델을 이용한 실시간 음성 대화.
• 텍스트-음성 변환(Text-to-speech), 장문 스튜디오 프로젝트, 음성 복제(voice cloning), 음성 디자인(voice design) 및 저장된 음성 기능.
• 전사(Transcription), 화자 분리(speaker diarization), 강제 정렬(forced alignment) 및 실시간 음성-텍스트 변환(realtime speech-to-text).
• 로컬 채팅, 모델 다운로드/로드/언로드/삭제, 기록(history), 내보내기(exports) 및 설정 기능.
• 모델, 채팅 완료(chat completions), 오디오 음성, 오디오 전사, 미리보기 응답 지원을 위한 OpenAI 호환 /v1 API.

추론 데이터는 로컬에 저장됩니다. 사용자가 명시적으로 옵트인하지 않는 한 선택적 익명 데스크톱 분석은 비활성화되며, 프롬프트, 전사 내용, 오디오 페이로드, 로컬 경로 또는 개인 식별자는 전송되지 않습니다.

설치 (Install)

GitHub 릴리스에서 최신 빌드를 다운로드하세요.

• macOS: .dmg를 설치하고, Izwi.app을 Applications 폴더로 드래그한 다음 실행합니다.
• Linux: sudo dpkg -i izwi_*.deb 명령어로 .deb 패키지를 설치합니다.
• Windows: .exe 설치 프로그램을 실행합니다.

런타임 지원은 아티팩트에 따라 다릅니다:

• macOS Apple Silicon의 릴리스 빌드는 macOS 15+에서 Metal을 사용하고 macOS 12-14에서는 CPU로 폴백합니다.
• Linux 및 Windows 릴리스 빌드는 CPU 전용입니다.
• CUDA는 호환되는 NVIDIA 호스트에서 Docker CUDA 프로파일 또는 소스 빌드를 통해 지원됩니다.

전체 계약 내용은 Runtime Support Matrix를 확인하세요.

빠른 시작 (Quick Start)

로컬 서버 및 웹 UI를 시작합니다:

izwi serve --mode web

서버 전용 모드와 데스크톱 모드도 사용할 수 있습니다:

izwi serve
izwi serve --mode desktop

모델을 다운로드하고 음성을 생성합니다:

izwi pull Qwen3-TTS-12Hz-0.6B-Base
izwi tts "Hello from Izwi." --output hello.wav

오디오를 전사(Transcribe)합니다:

izwi pull Parakeet-TDT-0.6B-v3
izwi transcribe audio.wav --model Parakeet-TDT-0.6B-v3

http://localhost:8080에서 앱을 엽니다. 로컬 API 참조는 http://localhost:8080/docs에서, 원시 OpenAPI 문서는 http://localhost:8080/openapi.json에서 확인할 수 있습니다.

모델 패밀리 (Model Families)

izwi list를 실행하여 활성화된 카탈로그를 확인하세요. 현재 지원되는 패밀리는 다음과 같습니다:

• TTS: Qwen3-TTS, Kokoro-82M, Voxtral TTS, VibeVoice.
• ASR: Parakeet, Whisper, Qwen3-ASR, Nemotron 3.5 ASR, VibeVoice ASR, LFM2.5 Audio, Voxtral Mini.
• 화자 분리 및 정렬 (Diarization and alignment): Sortformer diarization 및 Qwen3 ForcedAligner.
• 챗 (Chat): Qwen3, Qwen3.5, LFM2.5, Gemma.

일부 모델 가중치와 번들된 에셋은 자체 라이선스 또는 접근 약관을 가지고 있습니다. 다운로드한 모델 아티팩트를 재배포하거나 상업적으로 사용하기 전에 Models Guide를 확인하세요.

소스에서 빌드 (Build From Source)

CLI/서버 설치의 경우, 프로젝트 설치 스크립트를 사용합니다:

./scripts/install-cli.sh

수동으로 빌드하는 경우, 필요한 바이너리에 대해 Cargo 범위를 지정하세요:

cargo build --release -p izwi-cli
cargo build --release -p izwi-server

CUDA 소스 빌드는 대상 호스트에 맞는 CUDA 툴킷과 Cargo 기능을 필요로 합니다. 플랫폼별 설정을 위해서는 From Source를 참조하세요.

문서 (Documentation)

• Getting Started
• Installation
• Features
• CLI Reference
• API Reference
• Models
• Troubleshooting

라이선스 (License)

Izwi는 MIT License에 따라 라이선스가 부여됩니다.