Discover Music Skill

Find new music for Horus based on taste profile and external discovery services.

Quick Start

cd .pi/skills/discover-music

# Find similar artists
./run.sh similar "Chelsea Wolfe"

# Get trending artists
./run.sh trending --range week

# Search by genre/style tag
./run.sh search-tag "doom metal"

# Search by bridge attribute
./run.sh bridge Corruption

# Get fresh releases
./run.sh fresh

# Check API connectivity
./run.sh check

Discovery Services

| Service | API | Use For | |---------|-----|---------| | MusicBrainz | Free (User-Agent only) | Artist search, metadata, genre tags, relationships | | ListenBrainz | Free (token optional) | Similar artists, trending, user stats, recommendations |

No API keys required for basic functionality. ListenBrainz token enables personalized recommendations.

Commands

Similar Artists

./run.sh similar "<artist>" [--limit 10] [--json]

Find artists similar to a given artist via ListenBrainz + MusicBrainz tags fallback.

Trending Artists

./run.sh trending [--range week|month|year|all_time] [--limit 10] [--json]

Get site-wide trending artists from ListenBrainz.

Search by Tag

./run.sh search-tag "<tag>" [--limit 10] [--json]

Search MusicBrainz for artists by genre/style tag (e.g., "doom metal", "dark folk").

Search by Bridge

./run.sh bridge <attribute> [--limit 10] [--json]

Search for music matching an HMT bridge attribute:

| Bridge | MusicBrainz Tags | |--------|------------------| | Precision | progressive metal, math rock, technical death metal, djent | | Resilience | epic metal, power metal, post-rock, cinematic, symphonic metal | | Fragility | dark folk, acoustic, slowcore, sadcore, singer-songwriter | | Corruption | industrial, doom metal, sludge metal, dark ambient, noise | | Loyalty | neofolk, neoclassical, world, ritual ambient, medieval | | Stealth | drone, dark ambient, ambient, minimalist, atmospheric |

Fresh Releases

./run.sh fresh [--limit 10] [--json]

Get fresh/new releases from ListenBrainz explore API.

User Top Artists

./run.sh user-top <username> [--range all_time] [--limit 10] [--json]

Get a ListenBrainz user's top artists.

Check APIs

./run.sh check

Test connectivity to MusicBrainz and ListenBrainz APIs.

Integration with /dogpile

This skill can be invoked via /dogpile music:

# Via dogpile
/dogpile music "dark atmospheric metal similar to Chelsea Wolfe"

# Equivalent to
./run.sh similar "Chelsea Wolfe"
./run.sh search-tag "dark atmospheric metal"

Configuration

Environment variables (optional, in .env):

LISTENBRAINZ_TOKEN=xxx      # Optional: enables personalized recommendations
LISTENBRAINZ_USERNAME=xxx   # Optional: for user-specific queries

MusicBrainz requires no API key - only a User-Agent string (preconfigured as HorusAgent/1.0).

Crucial Dependencies

| Library | API/Method | Sanity Script | Status | |---------|------------|---------------|--------| | musicbrainzngs | MusicBrainz API | sanity/musicbrainz.py | [x] PASS | | pylistenbrainz | ListenBrainz API | sanity/listenbrainz.py | [x] PASS | | requests | HTTP client | N/A (well-known) | - |

Rate Limits

| Service | Limit | Implementation | |---------|-------|----------------| | MusicBrainz | 1 req/sec | Enforced in client | | ListenBrainz | ~2 req/sec | 0.5s minimum interval |

Example Horus Queries

# "What's similar to Chelsea Wolfe?"
./run.sh similar "Chelsea Wolfe" --limit 10

# "Find doom metal artists"
./run.sh search-tag "doom metal"

# "Music for a battle scene" (Resilience bridge)
./run.sh bridge Resilience

# "Dark ambient for corruption scene"
./run.sh bridge Corruption

# "What's trending this week?"
./run.sh trending --range week

# "New releases for discovery"
./run.sh fresh --json

Output Formats

All commands support --json for agent-parseable output:

[
  {"name": "Emma Ruth Rundle", "mbid": "abc123...", "similarity": 0.85},
  {"name": "Lingua Ignota", "mbid": "def456...", "similarity": 0.78}
]