{"id":31375928,"url":"https://github.com/cydanix/whisperclip","last_synced_at":"2025-10-03T13:34:09.367Z","repository":{"id":316908950,"uuid":"1065275713","full_name":"cydanix/whisperclip","owner":"cydanix","description":"Privacy-First Voice-to-Text with AI Enhancement for macOS","archived":false,"fork":false,"pushed_at":"2025-09-27T14:13:58.000Z","size":3857,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-27T15:05:55.211Z","etag":null,"topics":["llm-inference","local","macos","macos-app","macos-application","macosx","privacy","speech-to-text","voice-to-text","voice-to-text-transcription"],"latest_commit_sha":null,"homepage":"https://whisperclip.com","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cydanix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-27T11:54:02.000Z","updated_at":"2025-09-27T14:58:22.000Z","dependencies_parsed_at":"2025-09-27T15:19:21.930Z","dependency_job_id":null,"html_url":"https://github.com/cydanix/whisperclip","commit_stats":null,"previous_names":["cydanix/whisperclip"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/cydanix/whisperclip","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cydanix%2Fwhisperclip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cydanix%2Fwhisperclip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cydanix%2Fwhisperclip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cydanix%2Fwhisperclip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cydanix","download_url":"https://codeload.github.com/cydanix/whisperclip/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cydanix%2Fwhisperclip/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277318707,"owners_count":25798184,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-28T02:00:08.834Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["llm-inference","local","macos","macos-app","macos-application","macosx","privacy","speech-to-text","voice-to-text","voice-to-text-transcription"],"created_at":"2025-09-28T02:51:53.223Z","updated_at":"2025-09-28T02:51:54.111Z","avatar_url":"https://github.com/cydanix.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhisperClip\n\n\u003cdiv align=\"center\"\u003e\n\n![WhisperClip Logo](icons/icon_256x256.png)\n\n**Privacy-First Voice-to-Text with AI Enhancement for macOS**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![macOS](https://img.shields.io/badge/macOS-14%2B-blue.svg)](https://www.apple.com/macos/)\n[![Swift](https://img.shields.io/badge/Swift-5.10-orange.svg)](https://swift.org)\n\n[Website](https://whisperclip.com) • [Download](https://whisperclip.com/v2/download) • [Support](mailto:support@cydanix.com)\n\n\u003c/div\u003e\n\n## ✨ Features\n\n### 🎤 **Voice-to-Text Transcription**\n- High-quality speech recognition using WhisperKit\n- Multiple model sizes (216MB to 955MB) for different accuracy/speed trade-offs\n- Support for multiple languages with auto-detection\n- Real-time waveform visualization during recording\n\n### 🤖 **AI-Powered Text Enhancement**\n- Local LLM processing for grammar correction and text improvement\n- Multiple AI models including Gemma, Llama, Qwen, and Mistral\n- Custom prompts for different use cases:\n  - Grammar fixing and email formatting\n  - Language translation\n  - Custom text processing workflows\n\n### 🔒 **Privacy-First Design**\n- **100% local processing** - your voice never leaves your device\n- No cloud services, no data collection\n- Open source - audit the code yourself\n- Secure sandboxed environment\n\n### ⚡ **Productivity Features**\n- Global hotkey support (Option+Space by default)\n- Auto-copy to clipboard\n- Auto-paste functionality\n- Auto-enter for instant message sending\n- Menu bar integration\n- Auto-stop recording after 10 minutes\n\n### 🎨 **User Experience**\n- Beautiful dark-themed interface\n- Real-time recording visualization\n- Comprehensive onboarding guide\n- Easy model management and downloads\n- Customizable shortcuts and prompts\n\n## 📋 Requirements\n\n- **macOS 14.0** or later\n- **20GB** free disk space (for AI models)\n- **Microphone access** permission\n- **Accessibility permissions** (for global hotkeys)\n- **Apple Events permissions** (for clipboard operations)\n\n## 🚀 Installation\n\n### Download Pre-built App\n1. Visit [whisperclip.com](https://whisperclip.com)\n2. Download the latest release\n3. Drag WhisperClip.app to your Applications folder\n4. Follow the setup guide for permissions\n\n### Build from Source\n```bash\n# Clone the repository\ngit clone https://github.com/cydanix/whisperclip.git\ncd whisperclip\n\n# Build the app\n./build.sh\n\n# For development\n./local_build.sh Debug\n./local_run.sh Debug\n```\n\n## 🔧 Usage\n\n### Quick Start\n1. **Launch WhisperClip** from Applications or menu bar\n2. **Grant permissions** when prompted (microphone, accessibility)\n3. **Download AI models** through the setup guide\n4. **Press Option+Space** (or click Record) to start recording\n5. **Press again to stop** - text will be automatically copied to clipboard\n\n### Customization\n- **Change hotkey**: Settings → Hotkey preferences\n- **Add custom prompts**: Settings → Prompts → Add new prompt\n- **Switch AI models**: Setup Guide → Download different models\n- **Configure auto-actions**: Settings → Enable auto-paste/auto-enter\n\n## 🤖 Supported AI Models\n\n### Speech-to-Text (WhisperKit)\n- **OpenAI Whisper Small** (216MB) - Fast, good quality\n- **OpenAI Whisper Large v3 Turbo** (632MB) - Best balance\n- **Distil Whisper Large v3 Turbo** (600MB) - Optimized speed\n- **OpenAI Whisper Large v2 Turbo** (955MB) - Maximum accuracy\n\n### Text Enhancement (Local LLMs)\n- **Gemma 2 (2B/9B)** - Google's efficient models\n- **Llama 3/3.2 (3B/8B)** - Meta's powerful models\n- **Qwen 2.5/3 (1.5B-8B)** - Alibaba's multilingual models\n- **Mistral 7B** - High-quality French company model\n- **Phi 3.5 Mini** - Microsoft's compact model\n- **DeepSeek R1** - Advanced reasoning model\n\nAll models run locally using MLX for Apple Silicon optimization.\n\n## 🔒 Privacy \u0026 Security\n\nWhisperClip is designed with privacy as the cornerstone:\n\n- **Local Processing Only**: All voice recognition and AI processing happens on your device\n- **No Network Requests**: Except for downloading models from Hugging Face\n- **No Analytics**: No usage tracking, no telemetry, no data collection\n- **Open Source**: Full transparency - inspect the code yourself\n- **Sandboxed**: Runs in Apple's secure app sandbox\n- **Encrypted Storage**: AI models stored securely on device\n\n## 🛠 Development\n\n### Project Structure\n```\nSources/\n├── WhisperClip.swift      # Main app entry point\n├── ContentView.swift      # Main UI interface\n├── AudioRecorder.swift    # Voice recording logic\n├── VoiceToText*.swift     # Transcription engine\n├── LLM*.swift            # AI text enhancement\n├── ModelStorage.swift     # Model management\n├── SettingsStore.swift    # User preferences\n└── HotkeyManager.swift    # Global shortcuts\n```\n\n### Dependencies\n- **WhisperKit**: Apple's optimized Whisper implementation\n- **MLX**: Apple Silicon ML framework\n- **MLX-Swift-Examples**: LLM implementations\n- **Hub**: Hugging Face model downloads\n\n### Building\n```bash\n# Debug build\n./local_build.sh Debug\n\n# Release build with code signing\n./build.sh\n\n# Notarization (requires Apple Developer account)\n./notarize.sh\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our contributing guidelines:\n\n1. **Fork the repository**\n2. **Create a feature branch**: `git checkout -b feature/amazing-feature`\n3. **Make your changes** and add tests\n4. **Commit your changes**: `git commit -m 'Add amazing feature'`\n5. **Push to branch**: `git push origin feature/amazing-feature`\n6. **Open a Pull Request**\n\n### Areas for Contribution\n- New AI model integrations\n- UI/UX improvements\n- Performance optimizations\n- Language support\n- Accessibility features\n- Documentation improvements\n\n## 📄 License\n\nWhisperClip is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\nThis means you can:\n- ✅ Use commercially\n- ✅ Modify and distribute\n- ✅ Use privately\n- ✅ Fork and create derivatives\n\n**Attribution required**: Please include the original license notice.\n\n## 🏢 About\n\nWhisperClip is developed by **Cydanix LLC**.\n\n- **Website**: [whisperclip.com](https://whisperclip.com)\n- **Support**: [support@cydanix.com](mailto:support@cydanix.com)\n- **Version**: 1.0.43\n\n## 🙏 Acknowledgments\n\n- **Apple** - WhisperKit and MLX frameworks\n- **OpenAI** - Original Whisper models\n- **Hugging Face** - Model hosting and Hub library\n- **ML Community** - Open source AI models (Gemma, Llama, Qwen, etc.)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ for privacy-conscious users**\n\n[⭐ Star this repo](https://github.com/cydanix/whisperclip) if you find it useful!\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcydanix%2Fwhisperclip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcydanix%2Fwhisperclip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcydanix%2Fwhisperclip/lists"}