coder-music-cli 0.4.0__tar.gz → 0.5.0__tar.gz

{coder_music_cli-0.4.0 → coder_music_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coder-music-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: A command-line music application for coders with daemon support, radio streaming, and AI-generated music
 Author-email: Luong Nguyen <luongnv89@gmail.com>
 Maintainer-email: Luong Nguyen <luongnv89@gmail.com>
@@ -16,6 +16,7 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -31,7 +32,10 @@ Requires-Dist: tomli-w>=1.0
 Provides-Extra: ai
 Requires-Dist: torch>=2.0; extra == "ai"
 Requires-Dist: transformers<4.51,>=4.31; extra == "ai"
+Requires-Dist: diffusers>=0.15.0; extra == "ai"
 Requires-Dist: scipy>=1.10; extra == "ai"
+Requires-Dist: tqdm>=4.64; extra == "ai"
+Requires-Dist: accelerate>=0.20; extra == "ai"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
@@ -43,11 +47,21 @@ Requires-Dist: bandit>=1.7; extra == "dev"
 Requires-Dist: pre-commit>=3.0; extra == "dev"
 Dynamic: license-file
 
-# music-cli
+<p align="center">
+  <img src="assets/logo/logo-mark.svg" alt="music-cli logo" width="80" height="80">
+</p>
 
-[![PyPI version](https://img.shields.io/pypi/v/coder-music-cli.svg)](https://pypi.org/project/coder-music-cli/)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<h1 align="center">music-cli</h1>
+
+<p align="center">
+  <a href="https://pypi.org/project/coder-music-cli/"><img src="https://img.shields.io/pypi/v/coder-music-cli.svg" alt="PyPI version"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python 3.9+"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <img src="music-cli-ai.gif" alt="music-cli AI demo" width="600">
+</p>
 
 A command-line music player for coders. Background daemon with radio streaming, local MP3s, and AI-generated music.
 
@@ -68,23 +82,26 @@ pip install coder-music-cli
 uv pip install coder-music-cli
 
 # Install FFmpeg (required)
-brew install ffmpeg      # macOS
-sudo apt install ffmpeg  # Ubuntu/Debian
+brew install ffmpeg       # macOS
+sudo apt install ffmpeg   # Ubuntu/Debian
+choco install ffmpeg      # Windows (or: winget install ffmpeg)
 ```
 
 ### Optional: AI Music Generation
 
 ```bash
-pip install 'coder-music-cli[ai]'  # ~5GB (PyTorch + MusicGen via Transformers)
+pip install 'coder-music-cli[ai]'  # ~5GB (PyTorch + Transformers + Diffusers)
 ```
 
+Supports multiple AI models via HuggingFace: MusicGen, AudioLDM, and Bark.
+
 ## Features
 
 - **Daemon-based** - Persistent background playback
 - **Multiple sources** - Local files, radio streams, AI generation
 - **Context-aware** - Selects music based on time of day and mood
 - **35+ Radio Stations** - Curated stations in English, French, Spanish, and Italian
-- **AI Music Generation** - Generate music with MusicGen (saved for replay)
+- **AI Music Generation** - Generate music with MusicGen, AudioLDM, or Bark models
 - **Version-aware Updates** - Automatic notification when new stations are available
 - **Inspirational Quotes** - Random music quotes with every status check
 - **Simple config** - Human-readable text files
@@ -170,41 +187,84 @@ music-cli play -m history -i 3     # Replay item #3
 
 ## AI Music Generation
 
-Generate unique music with Meta's MusicGen model:
+Generate unique audio with multiple AI models via HuggingFace:
 
 ```bash
-# Install AI dependencies
+# Install AI dependencies (~5GB: PyTorch + Transformers + Diffusers)
 pip install 'coder-music-cli[ai]'
 
 # Generate and manage AI music
-music-cli ai play                         # Context-aware generation
-music-cli ai play -p "jazz piano"         # Custom prompt
-music-cli ai play --mood focus -d 30      # 30-second focus track
-music-cli ai list                         # List all generated tracks
-music-cli ai replay 1                     # Replay track #1
-music-cli ai remove 2                     # Delete track #2
+music-cli ai play                              # Context-aware (default: musicgen-small)
+music-cli ai play -p "jazz piano"              # Custom prompt
+music-cli ai play -m audioldm-s-full-v2        # Use AudioLDM model
+music-cli ai play -m bark-small -p "Hello!"    # Use Bark for speech
+music-cli ai play --mood focus -d 30           # 30-second focus track
+music-cli ai models                            # List available models
+music-cli ai list                              # List all generated tracks
+music-cli ai replay 1                          # Replay track #1
+music-cli ai remove 2                          # Delete track #2
 ```
 
+### Available AI Models
+
+| Model ID | Type | Best For | Size |
+|----------|------|----------|------|
+| `musicgen-small` | MusicGen | Music generation (default) | ~1.5GB |
+| `musicgen-medium` | MusicGen | Higher quality music | ~3GB |
+| `musicgen-large` | MusicGen | Best quality music | ~6GB |
+| `musicgen-melody` | MusicGen | Melody-conditioned music | ~3GB |
+| `audioldm-s-full-v2` | AudioLDM | Sound effects, ambient audio | ~1GB |
+| `audioldm-l-full` | AudioLDM | High-quality audio generation | ~2GB |
+| `bark` | Bark | Speech synthesis, audio with voice | ~5GB |
+| `bark-small` | Bark | Faster speech synthesis | ~1.5GB |
+
 ### AI Command Suite
 
 | Command | Description |
 |---------|-------------|
+| `ai models` | List all available AI models |
 | `ai list` | Show all AI-generated tracks with prompts |
 | `ai play` | Generate music from current context |
+| `ai play -m <model>` | Generate with specific model |
 | `ai play -p "prompt"` | Generate with custom prompt |
 | `ai play --mood focus` | Generate with specific mood |
 | `ai play -d 30` | Generate 30-second track (default: 5s) |
 | `ai replay <num>` | Replay track by number (regenerates if file missing) |
 | `ai remove <num>` | Delete track and audio file |
 
-Features:
+### Features
+- **Multiple models** - MusicGen, AudioLDM, and Bark model families
+- **Smart caching** - LRU cache keeps up to 2 models in memory (configurable)
+- **Download progress** - Progress bar shown during model downloads
+- **GPU memory management** - Automatic cleanup when switching models
 - **Context-aware** - Uses time of day, day of week, and session mood
 - **Custom prompts** - Generate exactly what you want with `-p`
 - **Seamless looping** - All tracks engineered for infinite playback
 - **Track management** - List, replay, and remove generated tracks
 - **Regeneration** - Missing files can be regenerated with original prompt
 - **Animated feedback** - "composing..." animation while generating
-- **Persistent storage** - Tracks saved to `~/.config/music-cli/ai_music/`
+- **Persistent storage** - Tracks saved to config directory
+
+### Requirements
+- ~5GB disk space minimum (PyTorch + Transformers + Diffusers)
+- ~8GB RAM minimum for generation (16GB recommended for larger models)
+- Models are downloaded on first use
+
+### Configuration
+
+Configure AI settings in `~/.config/music-cli/config.toml`:
+
+```toml
+[ai]
+default_model = "musicgen-small"  # Default model for generation
+
+[ai.cache]
+max_models = 2  # Max models to keep in memory (LRU eviction)
+
+[ai.models.audioldm-s-full-v2.extra_params]
+num_inference_steps = 10  # More = better quality, slower
+guidance_scale = 2.5      # How closely to follow prompt
+```
 
 ## Moods
 
@@ -212,7 +272,9 @@ Features:
 
 ## Configuration
 
-Files in `~/.config/music-cli/`:
+Configuration files location:
+- **Linux/macOS**: `~/.config/music-cli/`
+- **Windows**: `%LOCALAPPDATA%\music-cli\`
 
 | File | Purpose |
 |------|---------|
@@ -276,9 +338,29 @@ GitHub: https://github.com/luongnv89/music-cli
 
 - Python 3.9+
 - FFmpeg
+- **Supported Platforms**: Linux, macOS, Windows 10+
 
 ## Changelog
 
+### v0.5.0
+- Add multiple AI model support:
+  - **AudioLDM models**: `audioldm-s-full-v2`, `audioldm-l-full` for sound effects and ambient audio
+  - **Bark models**: `bark`, `bark-small` for speech synthesis
+  - **MusicGen models**: All existing models continue to work
+- Add `ai models` command to list all available AI models
+- Add LRU cache for AI models with configurable size (default: 2 models)
+- Add download progress bar during model downloads
+- Add GPU memory management with automatic cleanup on model eviction
+- Default model: `musicgen-small`
+
+### v0.4.1
+- Add Windows 10+ support
+  - Platform abstraction layer for cross-platform compatibility
+  - TCP localhost IPC on Windows (Unix sockets on Linux/macOS)
+  - stdin-based pause/resume on Windows (signals on Linux/macOS)
+  - Windows-specific config directory (`%LOCALAPPDATA%\music-cli\`)
+- Add Windows to CI test matrix
+
 ### v0.4.0
 - Add `music-cli ai` command suite for AI track management
   - `ai list` - Display all AI tracks with prompts

{coder_music_cli-0.4.0 → coder_music_cli-0.5.0}/README.md

@@ -1,8 +1,18 @@
-# music-cli
+<p align="center">
+  <img src="assets/logo/logo-mark.svg" alt="music-cli logo" width="80" height="80">
+</p>
 
-[![PyPI version](https://img.shields.io/pypi/v/coder-music-cli.svg)](https://pypi.org/project/coder-music-cli/)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<h1 align="center">music-cli</h1>
+
+<p align="center">
+  <a href="https://pypi.org/project/coder-music-cli/"><img src="https://img.shields.io/pypi/v/coder-music-cli.svg" alt="PyPI version"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python 3.9+"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <img src="music-cli-ai.gif" alt="music-cli AI demo" width="600">
+</p>
 
 A command-line music player for coders. Background daemon with radio streaming, local MP3s, and AI-generated music.
 
@@ -23,23 +33,26 @@ pip install coder-music-cli
 uv pip install coder-music-cli
 
 # Install FFmpeg (required)
-brew install ffmpeg      # macOS
-sudo apt install ffmpeg  # Ubuntu/Debian
+brew install ffmpeg       # macOS
+sudo apt install ffmpeg   # Ubuntu/Debian
+choco install ffmpeg      # Windows (or: winget install ffmpeg)
 ```
 
 ### Optional: AI Music Generation
 
 ```bash
-pip install 'coder-music-cli[ai]'  # ~5GB (PyTorch + MusicGen via Transformers)
+pip install 'coder-music-cli[ai]'  # ~5GB (PyTorch + Transformers + Diffusers)
 ```
 
+Supports multiple AI models via HuggingFace: MusicGen, AudioLDM, and Bark.
+
 ## Features
 
 - **Daemon-based** - Persistent background playback
 - **Multiple sources** - Local files, radio streams, AI generation
 - **Context-aware** - Selects music based on time of day and mood
 - **35+ Radio Stations** - Curated stations in English, French, Spanish, and Italian
-- **AI Music Generation** - Generate music with MusicGen (saved for replay)
+- **AI Music Generation** - Generate music with MusicGen, AudioLDM, or Bark models
 - **Version-aware Updates** - Automatic notification when new stations are available
 - **Inspirational Quotes** - Random music quotes with every status check
 - **Simple config** - Human-readable text files
@@ -125,41 +138,84 @@ music-cli play -m history -i 3     # Replay item #3
 
 ## AI Music Generation
 
-Generate unique music with Meta's MusicGen model:
+Generate unique audio with multiple AI models via HuggingFace:
 
 ```bash
-# Install AI dependencies
+# Install AI dependencies (~5GB: PyTorch + Transformers + Diffusers)
 pip install 'coder-music-cli[ai]'
 
 # Generate and manage AI music
-music-cli ai play                         # Context-aware generation
-music-cli ai play -p "jazz piano"         # Custom prompt
-music-cli ai play --mood focus -d 30      # 30-second focus track
-music-cli ai list                         # List all generated tracks
-music-cli ai replay 1                     # Replay track #1
-music-cli ai remove 2                     # Delete track #2
+music-cli ai play                              # Context-aware (default: musicgen-small)
+music-cli ai play -p "jazz piano"              # Custom prompt
+music-cli ai play -m audioldm-s-full-v2        # Use AudioLDM model
+music-cli ai play -m bark-small -p "Hello!"    # Use Bark for speech
+music-cli ai play --mood focus -d 30           # 30-second focus track
+music-cli ai models                            # List available models
+music-cli ai list                              # List all generated tracks
+music-cli ai replay 1                          # Replay track #1
+music-cli ai remove 2                          # Delete track #2
 ```
 
+### Available AI Models
+
+| Model ID | Type | Best For | Size |
+|----------|------|----------|------|
+| `musicgen-small` | MusicGen | Music generation (default) | ~1.5GB |
+| `musicgen-medium` | MusicGen | Higher quality music | ~3GB |
+| `musicgen-large` | MusicGen | Best quality music | ~6GB |
+| `musicgen-melody` | MusicGen | Melody-conditioned music | ~3GB |
+| `audioldm-s-full-v2` | AudioLDM | Sound effects, ambient audio | ~1GB |
+| `audioldm-l-full` | AudioLDM | High-quality audio generation | ~2GB |
+| `bark` | Bark | Speech synthesis, audio with voice | ~5GB |
+| `bark-small` | Bark | Faster speech synthesis | ~1.5GB |
+
 ### AI Command Suite
 
 | Command | Description |
 |---------|-------------|
+| `ai models` | List all available AI models |
 | `ai list` | Show all AI-generated tracks with prompts |
 | `ai play` | Generate music from current context |
+| `ai play -m <model>` | Generate with specific model |
 | `ai play -p "prompt"` | Generate with custom prompt |
 | `ai play --mood focus` | Generate with specific mood |
 | `ai play -d 30` | Generate 30-second track (default: 5s) |
 | `ai replay <num>` | Replay track by number (regenerates if file missing) |
 | `ai remove <num>` | Delete track and audio file |
 
-Features:
+### Features
+- **Multiple models** - MusicGen, AudioLDM, and Bark model families
+- **Smart caching** - LRU cache keeps up to 2 models in memory (configurable)
+- **Download progress** - Progress bar shown during model downloads
+- **GPU memory management** - Automatic cleanup when switching models
 - **Context-aware** - Uses time of day, day of week, and session mood
 - **Custom prompts** - Generate exactly what you want with `-p`
 - **Seamless looping** - All tracks engineered for infinite playback
 - **Track management** - List, replay, and remove generated tracks
 - **Regeneration** - Missing files can be regenerated with original prompt
 - **Animated feedback** - "composing..." animation while generating
-- **Persistent storage** - Tracks saved to `~/.config/music-cli/ai_music/`
+- **Persistent storage** - Tracks saved to config directory
+
+### Requirements
+- ~5GB disk space minimum (PyTorch + Transformers + Diffusers)
+- ~8GB RAM minimum for generation (16GB recommended for larger models)
+- Models are downloaded on first use
+
+### Configuration
+
+Configure AI settings in `~/.config/music-cli/config.toml`:
+
+```toml
+[ai]
+default_model = "musicgen-small"  # Default model for generation
+
+[ai.cache]
+max_models = 2  # Max models to keep in memory (LRU eviction)
+
+[ai.models.audioldm-s-full-v2.extra_params]
+num_inference_steps = 10  # More = better quality, slower
+guidance_scale = 2.5      # How closely to follow prompt
+```
 
 ## Moods
 
@@ -167,7 +223,9 @@ Features:
 
 ## Configuration
 
-Files in `~/.config/music-cli/`:
+Configuration files location:
+- **Linux/macOS**: `~/.config/music-cli/`
+- **Windows**: `%LOCALAPPDATA%\music-cli\`
 
 | File | Purpose |
 |------|---------|
@@ -231,9 +289,29 @@ GitHub: https://github.com/luongnv89/music-cli
 
 - Python 3.9+
 - FFmpeg
+- **Supported Platforms**: Linux, macOS, Windows 10+
 
 ## Changelog
 
+### v0.5.0
+- Add multiple AI model support:
+  - **AudioLDM models**: `audioldm-s-full-v2`, `audioldm-l-full` for sound effects and ambient audio
+  - **Bark models**: `bark`, `bark-small` for speech synthesis
+  - **MusicGen models**: All existing models continue to work
+- Add `ai models` command to list all available AI models
+- Add LRU cache for AI models with configurable size (default: 2 models)
+- Add download progress bar during model downloads
+- Add GPU memory management with automatic cleanup on model eviction
+- Default model: `musicgen-small`
+
+### v0.4.1
+- Add Windows 10+ support
+  - Platform abstraction layer for cross-platform compatibility
+  - TCP localhost IPC on Windows (Unix sockets on Linux/macOS)
+  - stdin-based pause/resume on Windows (signals on Linux/macOS)
+  - Windows-specific config directory (`%LOCALAPPDATA%\music-cli\`)
+- Add Windows to CI test matrix
+
 ### v0.4.0
 - Add `music-cli ai` command suite for AI track management
   - `ai list` - Display all AI tracks with prompts

{coder_music_cli-0.4.0 → coder_music_cli-0.5.0}/coder_music_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coder-music-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: A command-line music application for coders with daemon support, radio streaming, and AI-generated music
 Author-email: Luong Nguyen <luongnv89@gmail.com>
 Maintainer-email: Luong Nguyen <luongnv89@gmail.com>
@@ -16,6 +16,7 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -31,7 +32,10 @@ Requires-Dist: tomli-w>=1.0
 Provides-Extra: ai
 Requires-Dist: torch>=2.0; extra == "ai"
 Requires-Dist: transformers<4.51,>=4.31; extra == "ai"
+Requires-Dist: diffusers>=0.15.0; extra == "ai"
 Requires-Dist: scipy>=1.10; extra == "ai"
+Requires-Dist: tqdm>=4.64; extra == "ai"
+Requires-Dist: accelerate>=0.20; extra == "ai"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
@@ -43,11 +47,21 @@ Requires-Dist: bandit>=1.7; extra == "dev"
 Requires-Dist: pre-commit>=3.0; extra == "dev"
 Dynamic: license-file
 
-# music-cli
+<p align="center">
+  <img src="assets/logo/logo-mark.svg" alt="music-cli logo" width="80" height="80">
+</p>
 
-[![PyPI version](https://img.shields.io/pypi/v/coder-music-cli.svg)](https://pypi.org/project/coder-music-cli/)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+<h1 align="center">music-cli</h1>
+
+<p align="center">
+  <a href="https://pypi.org/project/coder-music-cli/"><img src="https://img.shields.io/pypi/v/coder-music-cli.svg" alt="PyPI version"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python 3.9+"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <img src="music-cli-ai.gif" alt="music-cli AI demo" width="600">
+</p>
 
 A command-line music player for coders. Background daemon with radio streaming, local MP3s, and AI-generated music.
 
@@ -68,23 +82,26 @@ pip install coder-music-cli
 uv pip install coder-music-cli
 
 # Install FFmpeg (required)
-brew install ffmpeg      # macOS
-sudo apt install ffmpeg  # Ubuntu/Debian
+brew install ffmpeg       # macOS
+sudo apt install ffmpeg   # Ubuntu/Debian
+choco install ffmpeg      # Windows (or: winget install ffmpeg)
 ```
 
 ### Optional: AI Music Generation
 
 ```bash
-pip install 'coder-music-cli[ai]'  # ~5GB (PyTorch + MusicGen via Transformers)
+pip install 'coder-music-cli[ai]'  # ~5GB (PyTorch + Transformers + Diffusers)
 ```
 
+Supports multiple AI models via HuggingFace: MusicGen, AudioLDM, and Bark.
+
 ## Features
 
 - **Daemon-based** - Persistent background playback
 - **Multiple sources** - Local files, radio streams, AI generation
 - **Context-aware** - Selects music based on time of day and mood
 - **35+ Radio Stations** - Curated stations in English, French, Spanish, and Italian
-- **AI Music Generation** - Generate music with MusicGen (saved for replay)
+- **AI Music Generation** - Generate music with MusicGen, AudioLDM, or Bark models
 - **Version-aware Updates** - Automatic notification when new stations are available
 - **Inspirational Quotes** - Random music quotes with every status check
 - **Simple config** - Human-readable text files
@@ -170,41 +187,84 @@ music-cli play -m history -i 3     # Replay item #3
 
 ## AI Music Generation
 
-Generate unique music with Meta's MusicGen model:
+Generate unique audio with multiple AI models via HuggingFace:
 
 ```bash
-# Install AI dependencies
+# Install AI dependencies (~5GB: PyTorch + Transformers + Diffusers)
 pip install 'coder-music-cli[ai]'
 
 # Generate and manage AI music
-music-cli ai play                         # Context-aware generation
-music-cli ai play -p "jazz piano"         # Custom prompt
-music-cli ai play --mood focus -d 30      # 30-second focus track
-music-cli ai list                         # List all generated tracks
-music-cli ai replay 1                     # Replay track #1
-music-cli ai remove 2                     # Delete track #2
+music-cli ai play                              # Context-aware (default: musicgen-small)
+music-cli ai play -p "jazz piano"              # Custom prompt
+music-cli ai play -m audioldm-s-full-v2        # Use AudioLDM model
+music-cli ai play -m bark-small -p "Hello!"    # Use Bark for speech
+music-cli ai play --mood focus -d 30           # 30-second focus track
+music-cli ai models                            # List available models
+music-cli ai list                              # List all generated tracks
+music-cli ai replay 1                          # Replay track #1
+music-cli ai remove 2                          # Delete track #2
 ```
 
+### Available AI Models
+
+| Model ID | Type | Best For | Size |
+|----------|------|----------|------|
+| `musicgen-small` | MusicGen | Music generation (default) | ~1.5GB |
+| `musicgen-medium` | MusicGen | Higher quality music | ~3GB |
+| `musicgen-large` | MusicGen | Best quality music | ~6GB |
+| `musicgen-melody` | MusicGen | Melody-conditioned music | ~3GB |
+| `audioldm-s-full-v2` | AudioLDM | Sound effects, ambient audio | ~1GB |
+| `audioldm-l-full` | AudioLDM | High-quality audio generation | ~2GB |
+| `bark` | Bark | Speech synthesis, audio with voice | ~5GB |
+| `bark-small` | Bark | Faster speech synthesis | ~1.5GB |
+
 ### AI Command Suite
 
 | Command | Description |
 |---------|-------------|
+| `ai models` | List all available AI models |
 | `ai list` | Show all AI-generated tracks with prompts |
 | `ai play` | Generate music from current context |
+| `ai play -m <model>` | Generate with specific model |
 | `ai play -p "prompt"` | Generate with custom prompt |
 | `ai play --mood focus` | Generate with specific mood |
 | `ai play -d 30` | Generate 30-second track (default: 5s) |
 | `ai replay <num>` | Replay track by number (regenerates if file missing) |
 | `ai remove <num>` | Delete track and audio file |
 
-Features:
+### Features
+- **Multiple models** - MusicGen, AudioLDM, and Bark model families
+- **Smart caching** - LRU cache keeps up to 2 models in memory (configurable)
+- **Download progress** - Progress bar shown during model downloads
+- **GPU memory management** - Automatic cleanup when switching models
 - **Context-aware** - Uses time of day, day of week, and session mood
 - **Custom prompts** - Generate exactly what you want with `-p`
 - **Seamless looping** - All tracks engineered for infinite playback
 - **Track management** - List, replay, and remove generated tracks
 - **Regeneration** - Missing files can be regenerated with original prompt
 - **Animated feedback** - "composing..." animation while generating
-- **Persistent storage** - Tracks saved to `~/.config/music-cli/ai_music/`
+- **Persistent storage** - Tracks saved to config directory
+
+### Requirements
+- ~5GB disk space minimum (PyTorch + Transformers + Diffusers)
+- ~8GB RAM minimum for generation (16GB recommended for larger models)
+- Models are downloaded on first use
+
+### Configuration
+
+Configure AI settings in `~/.config/music-cli/config.toml`:
+
+```toml
+[ai]
+default_model = "musicgen-small"  # Default model for generation
+
+[ai.cache]
+max_models = 2  # Max models to keep in memory (LRU eviction)
+
+[ai.models.audioldm-s-full-v2.extra_params]
+num_inference_steps = 10  # More = better quality, slower
+guidance_scale = 2.5      # How closely to follow prompt
+```
 
 ## Moods
 
@@ -212,7 +272,9 @@ Features:
 
 ## Configuration
 
-Files in `~/.config/music-cli/`:
+Configuration files location:
+- **Linux/macOS**: `~/.config/music-cli/`
+- **Windows**: `%LOCALAPPDATA%\music-cli\`
 
 | File | Purpose |
 |------|---------|
@@ -276,9 +338,29 @@ GitHub: https://github.com/luongnv89/music-cli
 
 - Python 3.9+
 - FFmpeg
+- **Supported Platforms**: Linux, macOS, Windows 10+
 
 ## Changelog
 
+### v0.5.0
+- Add multiple AI model support:
+  - **AudioLDM models**: `audioldm-s-full-v2`, `audioldm-l-full` for sound effects and ambient audio
+  - **Bark models**: `bark`, `bark-small` for speech synthesis
+  - **MusicGen models**: All existing models continue to work
+- Add `ai models` command to list all available AI models
+- Add LRU cache for AI models with configurable size (default: 2 models)
+- Add download progress bar during model downloads
+- Add GPU memory management with automatic cleanup on model eviction
+- Default model: `musicgen-small`
+
+### v0.4.1
+- Add Windows 10+ support
+  - Platform abstraction layer for cross-platform compatibility
+  - TCP localhost IPC on Windows (Unix sockets on Linux/macOS)
+  - stdin-based pause/resume on Windows (signals on Linux/macOS)
+  - Windows-specific config directory (`%LOCALAPPDATA%\music-cli\`)
+- Add Windows to CI test matrix
+
 ### v0.4.0
 - Add `music-cli ai` command suite for AI track management
   - `ai list` - Display all AI tracks with prompts

{coder_music_cli-0.4.0 → coder_music_cli-0.5.0}/coder_music_cli.egg-info/SOURCES.txt

@@ -18,6 +18,10 @@ music_cli/history.py
 music_cli/context/__init__.py
 music_cli/context/mood.py
 music_cli/context/temporal.py
+music_cli/platform/__init__.py
+music_cli/platform/ipc.py
+music_cli/platform/paths.py
+music_cli/platform/player_control.py
 music_cli/player/__init__.py
 music_cli/player/base.py
 music_cli/player/ffplay.py
@@ -25,6 +29,15 @@ music_cli/sources/__init__.py
 music_cli/sources/ai_generator.py
 music_cli/sources/local.py
 music_cli/sources/radio.py
+music_cli/sources/ai_models/__init__.py
+music_cli/sources/ai_models/audioldm_strategy.py
+music_cli/sources/ai_models/bark_strategy.py
+music_cli/sources/ai_models/model_config.py
+music_cli/sources/ai_models/model_registry.py
+music_cli/sources/ai_models/model_strategy.py
+music_cli/sources/ai_models/musicgen_strategy.py
+music_cli/sources/ai_models/progress_callback.py
+music_cli/sources/ai_models/strategy_cache.py
 tests/test_ai_tracks.py
 tests/test_config.py
 tests/test_context.py

{coder_music_cli-0.4.0 → coder_music_cli-0.5.0}/coder_music_cli.egg-info/requires.txt

@@ -7,7 +7,10 @@ tomli>=2.0
 [ai]
 torch>=2.0
 transformers<4.51,>=4.31
+diffusers>=0.15.0
 scipy>=1.10
+tqdm>=4.64
+accelerate>=0.20
 
 [dev]
 pytest>=7.0

{coder_music_cli-0.4.0 → coder_music_cli-0.5.0}/music_cli/__init__.py

@@ -1,4 +1,4 @@
 """music-cli: A command-line music application for coders."""
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"
 __github_url__ = "https://github.com/luongnv89/music-cli"