# mlx-music

Music generation on Apple Silicon with MLX.

## Status

Early development. First model: [ACE-Step 1.5](https://github.com/ace-step/ACE-Step-1.5).

## Installation

```bash
pip install mlx-music
```

## Planned Usage

```bash
# Generate music from text
mlx-music generate --model acestep \
  --caption "upbeat electronic dance music, 120 bpm" \
  --duration 30 --output my_song.wav
```

## Supported Models

| Model | Status | Paper |
|-------|--------|-------|
| ACE-Step 1.5 (2B) | In progress | [arXiv](https://arxiv.org/abs/2602.00744) |

## Requirements

- macOS with Apple Silicon (M1+)
- Python 3.11+
- MLX 0.25.2+

## License

MIT
