VoiceMode

Claude Code ile (ve diğer MCP özellikli ajanlarla) doğal sesli konuşmalar

VoiceMode, Claude Code ile doğal sesli konuşmalar yapmanızı sağlar. Ses, yazı yazmayı değiştirmekle ilgili değil - yazı yazmanın mümkün olmadığı durumlarda mevcut olmakla ilgili.

Mükemmel şu durumlar için:

• Bir sonraki toplantıya yürüyüş sırasında
• Hata ayıklama yaparken yemek pişirirken
• Saatlerce ekran karşısında geçirdikten sonra gözlerinize ara vermek için
• Kahve tutarken (ya da bir köpek tutarken)
• El ve gözleriniz meşgul olduğu her an

İş Başında Görmek

Hızlı Başlangıç

Gereksinimler: Mikrofon ve hoparlörlü bilgisayar

Seçenek 1: Claude Code Plugin (Önerilen)

Claude Code kullanıcıları için en hızlı başlama yöntemi:

# VoiceMode marketplace'ini ekleyin
claude plugin marketplace add mbailey/voicemode

# VoiceMode plugin'ini yükleyin
claude plugin install voicemode@voicemode

## Bağımlılıkları yükleyin (CLI, Yerel Ses Hizmetleri)

/voicemode:install

# Konuşmaya başlayın!
/voicemode:converse

Seçenek 2: Python installer paketi

Bağımlılıkları ve VoiceMode Python paketini yükler.

# UV paket yöneticisini yükleyin (gerekirse)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Installer'ı çalıştırın (bağımlılıkları ve yerel ses hizmetlerini kurar)
uvx voice-mode-install

# Claude Code'a ekleyin
claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher

# İsteğe bağlı: Yerel hizmetler için fallback olarak OpenAI API anahtarını ekleyin
export OPENAI_API_KEY=your-openai-key

# Bir konuşma başlatın
claude converse

Manual kurulum için Getting Started Guide bölümüne bakınız.

Özellikler

• Doğal konuşmalar - doğal şekilde konuşun, yanıtları anında dinleyin
• Çevrimdışı çalışır - isteğe bağlı yerel ses hizmetleri (Whisper STT, Kokoro TTS)
• Düşük gecikme süresi - gerçek bir konuşma kadar hızlı
• Akıllı sessizlik algılaması - konuşmayı bıraktığınızda kaydı durdurur
• Gizlilik seçenekleri - tamamen yerel olarak veya bulut hizmetlerini kullanarak çalıştırın

Uyumluluk

Platformlar: Linux, macOS, Windows (WSL), NixOS Python: 3.10-3.14

Yapılandırma

VoiceMode kutusundan çalışır. Özelleştirmek için:

# OpenAI API anahtarını ayarlayın (bulut hizmetlerini kullanıyorsanız)
export OPENAI_API_KEY="your-key"

# Veya dosyadan yapılandırın
voicemode config edit

Tüm seçenekler için Configuration Guide bölümüne bakınız.

İzinler Kurulumu (İsteğe Bağlı)

VoiceMode'u izin istemeden kullanmak için ~/.claude/settings.json dosyasına ekleyin:

{
  "permissions": {
    "allow": [
      "mcp__voicemode__converse",
      "mcp__voicemode__service"
    ]
  }
}

Daha fazla seçenek için Permissions Guide bölümüne bakınız.

Yerel Ses Hizmetleri

Gizlilik veya çevrimdışı kullanım için yerel ses hizmetlerini yükleyin:

• Whisper.cpp - Yerel konuşmayı metne dönüştürme
• Kokoro - Birden fazla sesli yerel metinden konuşmaya

Bunlar OpenAI ile aynı API'yi sağladığından VoiceMode aralarında sorunsuzca geçiş yapar.

Kurulum Detayları

sudo apt update
sudo apt install -y ffmpeg gcc libasound2-dev libasound2-plugins libportaudio2 portaudio19-dev pulseaudio pulseaudio-utils python3-dev

sudo dnf install alsa-lib-devel ffmpeg gcc portaudio portaudio-devel python3-devel

brew install ffmpeg node portaudio

# Geliştirme shell'ini kullanın
nix develop github:mbailey/voicemode

# Veya sistem genelinde yükleyin
nix profile install github:mbailey/voicemode

git clone https://github.com/mbailey/voicemode.git
cd voicemode
uv tool install -e .

# /etc/nixos/configuration.nix içinde
environment.systemPackages = [
  (builtins.getFlake "github:mbailey/voicemode").packages.${pkgs.system}.default
];

Sorun Giderme

Hata Ayıklama için Sesi Kaydedin

export VOICEMODE_SAVE_AUDIO=true
# Dosyalar ~/.voicemode/audio/YYYY/MM/ dizinine kaydedilir

Dokümantasyon

• Getting Started - Tam kurulum rehberi
• Configuration - Tüm ortam değişkenleri
• Whisper Setup - Yerel konuşmayı metne dönüştürme
• Kokoro Setup - Yerel metinden konuşmaya
• Development Setup - Katkıda bulunma rehberi

Tam dokümantasyon: voice-mode.readthedocs.io

Bağlantılar

• Website: getvoicemode.com
• GitHub: github.com/mbailey/voicemode
• PyPI: pypi.org/project/voice-mode
• YouTube: @getvoicemode
• Twitter/X: @getvoicemode
• Newsletter:

Lisans

MIT - A Failmode Project

mcp-name: com.failmode/voicemode