Fehlerbehebung
Kokoro ist von NautPin aus nicht erreichbar
Prüfen Sie mit lsof -nP -iTCP:8880 -sTCP:LISTEN, ob Docker den Port an Loopback oder eine andere Schnittstelle gebunden hat. Die lokale Installation sollte auf 127.0.0.1 lauschen. Kontrollieren Sie die Portzuordnung, bevor Sie die App-URL ändern.
Die LM Studio-API gibt nichts zurück
Der API-Server muss explizit auf der Registerkarte "Entwickler" von LM Studio gestartet werden. Es reicht nicht aus, nur ein Modell für den Chat zu laden.
Der Hook spricht die vorherige Antwort, nicht die aktuelle
Das kann passieren, wenn der Hook das Transkript liest, bevor die aktuelle Antwort vollständig geschrieben wurde. Die veröffentlichte Datei speak.sh wartet dafür auf einen stabilen Änderungszeitpunkt. Ergänzen Sie bei einem eigenen Hook vor dem Lesen eine Wartezeit von 250 ms.
Emma liest Pfeile laut vor
Entfernen Sie Unicode-Pfeile und Schrägstriche, bevor Sie Text an Kokoro senden. Der veröffentlichte Hook erledigt dies im Markdown-Cleanup-Schritt.
Lange Antworten überspringen TTS
Der Hook überspringt Antworten über 2000 Zeichen, damit die Sprachausgabe nicht zu lang wird. Passen Sie bei Bedarf MAX_CHARS am Anfang von speak.sh an.
Das Diktat ist in der falschen Sprache
Wechseln Sie zum Transkriptionsmodell Parakeet European multilingual. Die Whisper-Variante .en unterstützt nur Englisch.
Der Kokoro-Container verschwand nach dem Neustart
Colimas Linux-VM startet standardmässig nicht automatisch bei der Anmeldung. Führen Sie nach einem Neustart colima start aus oder registrieren Sie dafür einen launchd-Agenten. Die Kurzfassung:
Colima-Autostart
cat > ~/Library/LaunchAgents/com.user.colima.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key><string>com.user.colima</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/colima</string>
<string>start</string>
</array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><false/>
</dict>
</plist>
EOF
launchctl load ~/Library/LaunchAgents/com.user.colima.plistWenn Sie Docker Desktop verwenden, überprüfen Sie, ob es ausgeführt wird und so konfiguriert ist, dass es beim Anmelden startet.
Ollama funktioniert, aber NautPin sagt, dass das Modell nicht gefunden wurde
Ollama stellt Modellkennungen etwas anders dar als LM Studio. Der Modellname unter NautPin → Settings → AI Enhancement muss exakt zur Ausgabe von ollama list passen. Verwenden Sie beispielsweise gemma3:4b statt gemma3.
Was Sie jetzt haben
- Eine Diktier-App, die Wispr Flow in puncto Geschwindigkeit, Datenschutz und Kosten übertrifft
- KI-Bereinigung, die Ihren Fachjargon respektiert und niemals Ihre Maschine verlässt
- Sprachausgabe nicht von den Cloud-bezahlten Alternativen zu unterscheiden
- Eine vollständige Sprachkonversationsschleife mit Claude Code (und leicht an jede andere textbasierte KI anpassbar)
Alle Komponenten sind quelloffen. Die Docker-Images und Modelldateien können Sie kostenlos herunterladen. Es fallen keine Abonnements oder API-Gebühren an, und die Mikrofonaufnahmen verlassen den Mac nicht über das öffentliche Internet.
Das ist der ganze Stapel.
Der Kernstapel ist fertig. Agentenspezifische Voice Hooks sind eine separate optionale Erweiterung.
Es funktioniert, wenn
Docker, Kokoro und Ihr Modellserver sind erreichbar und NautPin führt nach dem Neustart weiterhin die Diktat- und Sprachprüfungen durch.