How powerbeef/vocello works
Vocello is a local-first voice-generation studio for macOS and iPhone, with a CLI. Its main workflow is to choose or prepare a voice, enter text and delivery settings, generate speech on-device, then listen to and manage the result. Major branches include voice design and cloning, long-form generation, model installation, local history, and export; iOS also documents a purchase gate for some exports. The README supports product-level flows, while sampled sources expose parts of the engine and model-management layers; unsampled implementation links are omitted.
Main entry points: GenerationSemantics.swift Generation request · GenerationOutputAdapter.swift Generated audio · MacStudioCanvas.swift Mac studio · DatabaseService.swift Generation history
Components 25
Studio experience
- Mac studio
Sources/Views/Studio/MacStudioCanvas.swift - iPhone studio
Sources/iOS/Studio/StudioScreen.swift - CLI generation
Sources/VocelloCLI/GenerateCommand.swift
Voice workflows
- Voice catalog
Sources/QwenVoiceCore/ProductionModelCatalog.swift - Voice design
Sources/Views/Studio/MacVoiceDesignScreen.swift - Voice cloning
Sources/Views/Studio/MacVoiceCloningScreen.swift - Clone consent
Sources/QwenVoiceCore/VoiceCloningConsentPolicy.swift - Saved voices
Sources/QwenVoiceCore/PreparedVoiceRepository.swift
Generation runtime
- Generation request
Sources/QwenVoiceCore/GenerationSemantics.swift - Engine facade
Sources/iOS/TTSEngineStore.swift - Backend adapter
Sources/QwenVoiceCore/AnyTTSEngineBackend.swift - MLX engine
Sources/QwenVoiceCore/MLXTTSEngine.swift - Native runtime
Sources/QwenVoiceCore/NativeEngineRuntime.swift - Qwen model engine
Packages/VocelloQwen3Core/Sources/VocelloQwen3Core/Engine.swift - Generated audio
Sources/QwenVoiceCore/GenerationOutputAdapter.swift
Models and library
- Model manager
Sources/ViewModels/ModelManagerViewModel.swift - Model downloads
Sources/QwenVoiceCore/HuggingFaceDownloader.swift - Generation history
Sources/iOSSupport/Services/DatabaseService.swift - Live playback
Sources/SharedSupport/Services/LiveStreamingPlaybackEngine.swift
Platform services
- Audio marking
Sources/QwenVoiceCore/AudioPublicationMarking.swift - iOS export gate
Sources/iOS/Commerce/IOSExportGate.swift - Audio export
Sources/Services/AudioService.swift
Other components
- Mac user
- iPhone user
- CLI caller
Connections 28
- Mac user → Mac studio: writes and selects
README.md - iPhone user → iPhone studio: writes and selects
README.md - CLI caller → CLI generation: submits request
README.md - Mac studio → Generation request: configures speech
README.md - iPhone studio → Generation request: configures speech
README.md - CLI generation → Generation request: configures speech
README.md - Voice catalog → Mac studio: offers speakers
README.md - Voice design → Generation request: supplies voice brief
README.md - Voice cloning → Clone consent: requires consent
README.md - Voice cloning → Saved voices: saves reference
README.md - Saved voices → Generation request: conditions voice
README.md - Mac studio → Voice design: starts design
README.md - iPhone studio → Voice cloning: starts cloning
README.md - Generation request → Engine facade: submits generation
README.md - Engine facade → Backend adapter: delegates calls
Sources/iOS/TTSEngineStore.swift - Backend adapter → MLX engine: forwards operations
Sources/QwenVoiceCore/AnyTTSEngineBackend.swift - MLX engine → Native runtime: runs generation
Sources/QwenVoiceCore/MLXTTSEngine.swift - Native runtime → Qwen model engine: uses model runtime
- Qwen model engine → Generated audio: produces speech
- Model manager → Model downloads: downloads artifacts
Sources/ViewModels/ModelManagerViewModel.swift - Model downloads → Voice catalog: installs model assets
Sources/QwenVoiceCore/ProductionModelCatalog.swift - Generation request → Generation history: records generation
README.md - Generated audio → Live playback: streams for listening
README.md - Generated audio → Generation history: keeps local result
README.md - Generated audio → Audio marking: marks finished take
README.md - Generation history → Audio export: exports selected audio
README.md - iOS export gate → Audio export: authorizes paid export
README.md - Generation request → Generation history: stores long-form segments
README.md