https://github.com/cliffmin/homebrew-tap
Homebrew tap for installing VoxCompose and other tools
https://github.com/cliffmin/homebrew-tap
homebrew homebrew-tap macos package-manager ruby
Last synced: 2 months ago
JSON representation
Homebrew tap for installing VoxCompose and other tools
- Host: GitHub
- URL: https://github.com/cliffmin/homebrew-tap
- Owner: cliffmin
- License: mit
- Created: 2025-09-09T10:31:54.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T23:08:35.000Z (3 months ago)
- Last Synced: 2026-03-29T01:42:38.163Z (3 months ago)
- Topics: homebrew, homebrew-tap, macos, package-manager, ruby
- Language: Ruby
- Homepage: https://github.com/cliffmin/voxcompose
- Size: 25.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Homebrew Tap
Homebrew formulae for the VoxCore ecosystem -- local voice-to-text on macOS.
## Installation
```bash
brew tap cliffmin/tap
```
## Formulae
### VoxCore
Offline push-to-talk transcription for macOS. One hotkey, any app, sub-second, 100% on-device.
```bash
brew install --cask hammerspoon
brew install voxcore
voxcore-install
```
After install, reload Hammerspoon (Cmd+Opt+Ctrl+R) and grant Microphone + Accessibility permissions.
**Repository:** https://github.com/cliffmin/voxcore
### VoxCompose (optional)
Self-learning transcript refinement plugin for VoxCore. Fixes concatenations, capitalizes technical terms, and optionally applies local LLM polish.
```bash
brew install voxcompose ollama
ollama serve &
ollama pull llama3.1
```
Then enable in `~/.hammerspoon/ptt_config.lua`:
```lua
LLM_REFINER = { ENABLED = true, CMD = { "voxcompose", "--duration" } }
```
**Repository:** https://github.com/cliffmin/voxcompose
## Upgrading
```bash
brew update
brew upgrade voxcore voxcompose
voxcore-install # Re-links Hammerspoon integration
# Reload Hammerspoon: Cmd+Opt+Ctrl+R
```
## Ecosystem
| Component | Purpose | Repository | Documentation |
|-----------|---------|------------|---------------|
| **VoxCore** | Core transcription engine | [cliffmin/voxcore](https://github.com/cliffmin/voxcore) | [Setup](https://github.com/cliffmin/voxcore/tree/main/docs/setup) · [Architecture](https://github.com/cliffmin/voxcore/blob/main/docs/development/architecture.md) · [Performance](https://github.com/cliffmin/voxcore/blob/main/docs/performance.md) |
| **VoxCompose** | ML transcript refinement (optional) | [cliffmin/voxcompose](https://github.com/cliffmin/voxcompose) | [Integration](https://github.com/cliffmin/voxcompose/blob/main/docs/voxcore-integration.md) · [Architecture](https://github.com/cliffmin/voxcompose/blob/main/docs/architecture.md) |
| **homebrew-tap** | Distribution via Homebrew | This repo | — |
## Troubleshooting
```bash
brew update # Refresh tap
brew info voxcore # Check installed version
brew reinstall voxcore # Clean reinstall
brew audit --strict voxcore # Check formula integrity
```
## License
All formulae are subject to their respective project licenses.