Metadata-Version: 2.4
Name: voxing
Version: 0.2.1
Summary: Voice assistant TUI powered by local MLX models
Author: yeungadrian
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: MacOS
Requires-Dist: huggingface-hub>=1.4.1
Requires-Dist: mlx>=0.30.6
Requires-Dist: mlx-lm>=0.30.7
Requires-Dist: numpy>=2.4.2
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pydantic-settings>=2.13.1
Requires-Dist: rich>=14.3.1
Requires-Dist: sounddevice>=0.5.3
Requires-Dist: textual>=7.5.0
Requires-Python: >=3.12, <3.15
Project-URL: Homepage, https://github.com/yeungadrian/Voxing
Project-URL: Repository, https://github.com/yeungadrian/Voxing
Description-Content-Type: text/markdown

# Voxing

A voice and text assistant that runs entirely on-device, built as a terminal UI for macOS with Apple Silicon.

Uses [MLX](https://github.com/ml-explore/mlx) for inference and [Textual](https://github.com/Textualize/textual) for the interface.

## Requirements

- macOS with Apple Silicon (M1+)

## Install

```bash
uvx voxing
```

## Models

| Task | Default Model |
|------|---------------|
| Speech-to-Text | [parakeet-tdt-0.6b-v3](https://huggingface.co/mlx-community/parakeet-tdt-0.6b-v3) |
| LLM | [LFM2.5-1.2B-Instruct-MLX-8bit](https://huggingface.co/LiquidAI/LFM2.5-1.2B-Instruct-MLX-8bit) |

## Usage

| Command | Description |
|---------|-------------|
| `/transcribe` | Record voice input with real-time waveform, stops on silence |
| `/settings` | Configure models, audio, and LLM parameters |
| `/clear` | Clear chat history |
| `/help` | Show available commands |
