An open API service indexing awesome lists of open source software.

https://github.com/charles-forsyth/generate-music

🎵 A modern, professional CLI for real-time AI music generation using Google's Vertex AI Lyria model.
https://github.com/charles-forsyth/generate-music

cli generative-ai google-cloud music-generation python vertex-ai

Last synced: 2 months ago
JSON representation

🎵 A modern, professional CLI for real-time AI music generation using Google's Vertex AI Lyria model.

Awesome Lists containing this project

README

          

# 🎵 Gen-Music CLI

![CI](https://github.com/charles-forsyth/generate-music/actions/workflows/ci.yml/badge.svg)
![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)
![License](https://img.shields.io/github/license/charles-forsyth/generate-music)
![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)

**Gen-Music** is a modern, professional command-line interface (CLI) for generating high-quality music in real-time using Google's state-of-the-art **Vertex AI Lyria model**.

## 🚀 Installation

### Using `uv` (Recommended)

```bash
uv tool install git+https://github.com/charles-forsyth/generate-music.git
```

## 🛠️ Configuration

After installation, initialize the configuration to set up your credentials:

```bash
gen-music --init
```

This creates a configuration file at `~/.config/gen-music/.env`. Edit it to add your **Google Cloud Project ID**.

## 🎹 Usage

**Generate a Track:**
```bash
gen-music "An epic orchestral soundtrack with swelling strings"
```

**Options:**
* `--duration, -d`: Length in seconds (default: 10).
* `--bpm`: Beats per minute (default: 120).
* `--play, -p`: Play immediately after generation.

**View History:**
```bash
gen-music --history
```

## 🤝 Contributing

Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md).

## 📄 License

Distributed under the MIT License. See `LICENSE` for more information.