← Back to Skills Marketplace
AI-Music-Stream
by
Ju-Chiang Wang
· GitHub ↗
· v1.0.4
· MIT-0
125
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install musestream
Description
Generate AI music from text prompts and stream continuously in-browser with a shareable player URL; all tracks are saved locally in a library.
Usage Guidance
Before installing: (1) Understand the missing declaration — the code requires a Sonauto API key (SONAUTO_API_KEY) via config.json or env, but the skill metadata lists none; do not share keys publicly or commit them to source control. (2) Review the musestream_server.py and restart script locally before running; the server will save generated audio and a log file in your chosen directory. (3) Do NOT expose the server to the internet without protections: add token-based auth, TLS reverse proxy, IP firewall rules, and rate-limiting as suggested in the README. (4) Be cautious about providing sensitive context (location, traffic) to the agent; limit context to what you consent to share. (5) If you plan messenger integration, expect to provide additional bot tokens — verify where and how those tokens are stored. (6) Ask the skill owner/registry to update the declared required env/credentials to reflect SONAUTO_API_KEY and any other secrets the code actually needs. If you are uncomfortable with these mismatches or exposing a local server, run the skill in an isolated environment (VM/container) or decline installation.
Capability Analysis
Type: OpenClaw Skill
Name: musestream
Version: 1.0.4
MuseStream is a legitimate AI music generation and streaming tool that integrates with the Sonauto API. The skill includes a Flask server (musestream_server.py) for managing generation tasks, proxying audio streams, and serving a local music library, with security measures like path traversal protection in the file-serving logic. While the server binds to all interfaces (0.0.0.0) and lacks built-in authentication, these risks are explicitly documented in the README.md along with instructions for users to secure their setup using firewalls or reverse proxies. No evidence of malicious intent, data exfiltration, or unauthorized persistence was found in the code or the agent instructions.
Capability Assessment
Purpose & Capability
The skill's description and SKILL.md describe a Sonauto-backed music generator and local streaming server. However the registry metadata lists no required environment variables or primary credential, while the code and SKILL.md clearly require a Sonauto API key (SONAUTO_API_KEY) and a config.json. This discrepancy between what is declared and what is actually required is incoherent and should be corrected.
Instruction Scope
Most runtime instructions stay within the stated purpose (start server, call /start, save files). However the docs explicitly encourage replacing 'localhost' with an external IP or using tunnels/reverse proxies to expose the service and recommend the agent perform substitutions — this increases the risk of unwanted external exposure. The SKILL.md also tells the agent to collect contextual info (time, weather, location, traffic, mood) to craft prompts; collecting location/traffic data is privacy-sensitive and should be limited to what the user consents to. Overall the instruction set gives broad discretion to expose the server externally and to collect contextual data, which is beyond a minimal local music-generator scope.
Install Mechanism
This is an instruction-and-code skill (no packaged install). It requires pip installing two common packages (flask, requests) from PyPI and running the included Python script. There are no downloads from unknown hosts, no archive extraction, and the restart script simply runs the included Python program via nohup — install risk is moderate-to-low but you should still review code before running.
Credentials
The code expects and uses SONAUTO_API_KEY (and optional MUSESTREAM_* config values stored in config.json) but the skill metadata declares no required env vars or primary credential. The server will persist logs (log.jsonl) and save generated audio to a user-specified directory. The messenger-bot integration mentioned in docs would likely require additional tokens, but no bot tokens are requested or declared. Requiring an API key and writing files is reasonable for this functionality, but the omission from declared requirements and lack of explicit guidance for secure secret storage is concerning.
Persistence & Privilege
The skill does not request elevated platform privileges and is not always-enabled. It runs a local Flask server, writes saved audio and a JSONL log to the selected output directory, and starts itself via a simple restart script. The biggest persistence/privilege risk is network exposure: the README/SKILL.md encourage exposing the local server (substituting external IP or using tunnels) which materially increases blast radius if done without authentication and TLS. The skill itself does not automatically modify other agent/system configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install musestream - After installation, invoke the skill by name or use
/musestream - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
MuseStream 1.0.4
- Default server port changed from 5000 to 5001.
- Environment variable setup instructions updated: `MUSESTREAM_PORT` now highlighted, and agents are prompted for preferred port; default paths/ports clarified.
- `restart_musestream.sh` now loads `.env` automatically; no need to source manually.
- All example requests and documentation updated to use port 5001.
- Improves clarity and flexibility for setup, especially around configuration of output directory and port.
v1.0.3
MuseStream Skill 1.0.3
- Improved setup instructions: now prompts user for preferred output directory and documents how to set `MUSESTREAM_OUTPUT_DIR` in `.env`.
- Default library location (`~/Music/MuseStream`) is now clearly stated and user-selectable during setup.
- No code changes detected; SKILL.md documentation updated for better clarity on configuring music output paths.
- All core features, endpoints, and provider setup remain unchanged.
v1.0.2
Major documentation overhaul clarifying agent workflow, provider support, and music prompt handling.
- Revised and expanded feature overview: clearer on core features, auto-queue behavior, and stream sharing.
- Stronger emphasis on agent role: agent must interpret/refine user prompts with its own LLM; server no longer rewrites prompts.
- Setup and environment sections streamlined for Sonauto as default, with guidance for adding new providers moved to the end.
- New and improved examples for prompt rewriting, context handling, and endpoint use.
- Messenger bot integration and security cautions highlighted.
- Mobile UI, library management, and all API endpoints updated and grouped for quick reference.
v1.0.1
- Initial release of the MuseStream skill as a standalone server package.
- Added main server script (`musestream_server.py`) for music generation, streaming, and local library management.
- Included startup automation (`restart_musestream.sh`) and dependency management (`requirements.txt`).
- Added comprehensive documentation (`README.md`) covering setup, API usage, and provider integration.
v1.0.0
MuseStream 1.0.0
- Initial release: AI music generation and seamless streaming with shareable player URLs.
- Songs are generated from natural language prompts or user context and saved locally.
- Features a browser-based player, library management, and mobile-friendly interface.
- Supports Sonauto as the default provider, with optional context prompt integration via MiniMax or Anthropic.
- Comprehensive REST API for starting, stopping, browsing, and streaming music sessions.
Metadata
Frequently Asked Questions
What is AI-Music-Stream?
Generate AI music from text prompts and stream continuously in-browser with a shareable player URL; all tracks are saved locally in a library. It is an AI Agent Skill for Claude Code / OpenClaw, with 125 downloads so far.
How do I install AI-Music-Stream?
Run "/install musestream" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AI-Music-Stream free?
Yes, AI-Music-Stream is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AI-Music-Stream support?
AI-Music-Stream is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AI-Music-Stream?
It is built and maintained by Ju-Chiang Wang (@asriverwang); the current version is v1.0.4.
More Skills