{"id":49028920,"url":"https://github.com/RamboRogers/MLX-Transcribe","last_synced_at":"2026-05-05T13:01:00.661Z","repository":{"id":306543098,"uuid":"1026453901","full_name":"RamboRogers/MLX-Transcribe","owner":"RamboRogers","description":"Instant Perfect Native MacOS Transcription","archived":false,"fork":false,"pushed_at":"2025-07-26T06:42:08.000Z","size":24718,"stargazers_count":54,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-04-16T03:37:00.883Z","etag":null,"topics":["mlx","mlx-gui","private","transcription"],"latest_commit_sha":null,"homepage":"https://mlxgui.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RamboRogers.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}},"created_at":"2025-07-25T23:25:15.000Z","updated_at":"2026-04-10T11:14:19.000Z","dependencies_parsed_at":"2025-07-26T11:25:08.749Z","dependency_job_id":"3d5b66de-6f32-4192-95c0-6418d53173dd","html_url":"https://github.com/RamboRogers/MLX-Transcribe","commit_stats":null,"previous_names":["ramborogers/mlx-transcribe"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/RamboRogers/MLX-Transcribe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RamboRogers%2FMLX-Transcribe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RamboRogers%2FMLX-Transcribe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RamboRogers%2FMLX-Transcribe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RamboRogers%2FMLX-Transcribe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RamboRogers","download_url":"https://codeload.github.com/RamboRogers/MLX-Transcribe/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RamboRogers%2FMLX-Transcribe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32650449,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["mlx","mlx-gui","private","transcription"],"created_at":"2026-04-19T09:00:36.931Z","updated_at":"2026-05-05T13:01:00.648Z","avatar_url":"https://github.com/RamboRogers.png","language":null,"funding_links":[],"categories":["Rising projects"],"sub_categories":[],"readme":"# 🎤 MLX-Transcribe\n\n![MLX-Transcribe Demo](media/demo.gif)\n\n\u003cp align=\"center\"\u003e*Press \"Control + ~\" → Speak → Text appears instantly at your cursor*\u003c/p\u003e\n\n---\n\n\u003e 🚀 **Lightning-fast AI transcription directly at your cursor** - The fastest way from voice to text\n\n[![License](https://img.shields.io/badge/license-Freeware-green.svg)](LICENSE)\n[![macOS](https://img.shields.io/badge/macOS-12.0+-success.svg)](https://www.apple.com/macos/)\n[![Architecture](https://img.shields.io/badge/arch-Intel%20%7C%20Apple%20Silicon-orange.svg)](https://github.com/RamboRogers/MLX-Transcribe/releases)\n[![GitHub stars](https://img.shields.io/github/stars/RamboRogers/MLX-Transcribe.svg?style=social\u0026label=Star)](https://github.com/RamboRogers/MLX-Transcribe)\n\n## 🎯 What is MLX-Transcribe?\n\nMLX-Transcribe is a ***NATIVE SIGNED*** **privacy-first**, **lightning-fast** transcription app for macOS that transforms your voice into text instantly at your cursor position. Built with Apple Silicon optimization and seamless integration with [MLX-GUI](https://github.com/RamboRogers/mlx-gui), it's the perfect tool for developers, writers, and anyone who values speed and privacy.\n\n\u003cimg src=\"media/trayapp.png\" alt=\"MLX-Transcribe\" width=\"500\" align=\"center\"\u003e\n\n### 🔥 Key Features\n\n- **⚡ Instant Transcription** - Press ``` Control + ` ```  and speak - text appears instantly at your cursor\n- **🤖 Local AI First** - Seamless [MLX-GUI](https://github.com/RamboRogers/mlx-gui) integration with automatic model management\n- **🛡️ Privacy Focused** - Your voice never leaves your machine with local processing\n- **🎛️ Multi-API Support** - Works with Local MLX, OpenAI, and Groq endpoints\n- **⌨️ Customizable Hotkeys** - Configure any key combination that works for you\n- **🎯 Universal Cursor** - Works in any app - text editors, browsers, chat apps, terminals\n- **🚀 Menu Bar Native** - Lightweight, always-accessible menu bar app\n- **🔄 Auto-Install Models** - Automatically downloads and loads Parakeet models via MLX-GUI\n- **🏃‍♂️ Startup Ready** - Optional login item for seamless workflow integration\n\n\n## 🚀 Quick Install\n\n1. Download the latest release from [Releases](https://github.com/RamboRogers/MLX-Transcribe/releases)\n2. Open the `.zip` file and drag MLX-Transcribe to Applications\n3. Launch and grant accessibility permissions when prompted\n\n## ⚙️ Setup\n\n### 1. 🎤 Microphone Permission\nMLX-Transcribe will automatically request microphone access on first launch.\n\n### 2. 🔓 Accessibility Permission\nFor text insertion at cursor:\n1. Click \"Grant Accessibility\" in the menu bar popup\n2. Add MLX-Transcribe to Privacy \u0026 Security → Accessibility\n3. **Restart the app** after granting permission\n\n### 3. 🤖 AI Configuration\n- **Local MLX** (Default): Integrates with [MLX-GUI](https://github.com/RamboRogers/mlx-gui) - models auto-install\n- **OpenAI**: Add your API key in settings\n- **Groq**: Add your Groq API key for fast cloud transcription\n\n## 🎮 Usage\n\n### Basic Transcription\n1. **Press `Control + ~`** (or your custom hotkey)\n2. **Speak clearly** while you see the red recording indicator\n3. **Press `Control + ~`** to stop recording, or `Control + ~` again\n4. **Text appears instantly** at your cursor position\n\n### Menu Bar Controls\nClick the 🎤 icon in your menu bar to:\n- View transcription status\n- Configure hotkeys and API settings\n- Enable \"Start on Login\"\n- Check permissions and connection status\n\n### Pro Tips\n- **Best Results**: Speak clearly and pause briefly between sentences\n- **Quick Stop**: Press `Control + ~` while recording to stop immediately\n- **Works Everywhere**: Terminal, VS Code, Slack, browsers, documents\n- **Privacy Mode**: Use local MLX processing to keep everything offline\n\n## 🛠️ API Configurations\n\n\u003cimg src=\"media/api.png\" alt=\"API Configurations\" width=\"500\" align=\"center\"\u003e\n\n### 🏠 Local MLX (Recommended)\n```\nEndpoint: http://127.0.0.1:8000/v1/audio/transcriptions\nModel: parakeet-tdt-0-6b-v2 (auto-installed)\nAPI Key: Not required\n```\n\n### ☁️ OpenAI\n```\nEndpoint: https://api.openai.com/v1/audio/transcriptions\nModel: whisper-1\nAPI Key: Required (sk-...)\n```\n\n### ⚡ Groq\n```\nEndpoint: https://api.groq.com/openai/v1/audio/transcriptions\nModel: whisper-large-v3-turbo\nAPI Key: Required (gsk_...)\n```\n\n## 🖥️ System Requirements\n\n- **macOS**: 12.0 (Monterey) or later\n- **Architecture**: Intel x86_64 or Apple Silicon (arm64)\n- **Memory**: 4GB RAM minimum, 8GB recommended\n- **Storage**: 50MB for app, additional space for local models\n- **For Local MLX**: [MLX-GUI](https://github.com/RamboRogers/mlx-gui) installed and running\n\n## 🔧 Advanced Configuration\n\n### Custom Hotkeys\nPopular combinations:\n- `Control + ~` (Default) - Great for developers\n- `Shift + Tab` - Alternative option\n- `Option + Space` - Quick access\n- `F5` - Function key option\n\n### Keyboard Shortcuts\n- **Start/Stop Recording**: Your configured hotkey (default: `Control + ~`)\n- **Force Stop**: `Control + ~` (while recording)\n- **Open Menu**: Click menu bar icon\n\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n1. **🐛 Report Issues**: Found a bug? [Open an issue](https://github.com/RamboRogers/MLX-Transcribe/issues)\n2. **💡 Feature Requests**: Have an idea? We'd love to hear it!\n3. **🔧 Code Contributions**: Fork, branch, commit, and PR\n4. **📖 Documentation**: Help improve our docs and examples\n5. **⭐ Star the Repo**: Show your support!\n\n## 📊 Performance\n\n| Metric | Local MLX | OpenAI | Groq |\n|--------|-----------|---------|------|\n| **Latency** | 🟢 ~2-4s | 🟡 ~3-8s | 🟢 ~1-3s |\n| **Privacy** | 🟢 100% Local | 🔴 Cloud | 🔴 Cloud |\n| **Accuracy** | 🟢 Excellent | 🟢 Excellent | 🟢 Excellent |\n| **Cost** | 🟢 Free | 🟡 $0.006/min | 🟡 $0.00011/min |\n\n## ⭐ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=RamboRogers/MLX-Transcribe\u0026type=Date)](https://star-history.com/#RamboRogers/MLX-Transcribe\u0026Date)\n\n## 🔗 Related Projects\n\n- **[MLX-GUI](https://github.com/RamboRogers/mlx-gui)** - The powerful MLX interface that powers local transcription\n- **[matthewrogers.org](https://matthewrogers.org)** - Creator's website and blog\n\n## 📜 License\n\nFreeware License - see [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with ❤️ by [Matthew Rogers](https://matthewrogers.org)\n- Powered by [MLX-GUI](https://github.com/RamboRogers/mlx-gui) for local AI processing\n- Uses Apple's Speech Recognition framework\n- Inspired by the need for privacy-first transcription tools\n\n---\n\n**Made with 🎤 and ⚡ for the developer community**\n\n*MLX-Transcribe - Where voice meets code at the speed of thought*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRamboRogers%2FMLX-Transcribe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRamboRogers%2FMLX-Transcribe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRamboRogers%2FMLX-Transcribe/lists"}