A music-obsessed AI agent in your terminal. Ask it what to listen to and it pulls from the live BeatBrain discover feed — aggregating Spotify New Releases, Reddit [FRESH], Billboard, Pitchfork Best New Music, and HotNewHipHop. Deep-dive into any track's production credits, instruments, BPM, key, and audio features. Explore artist profiles and genre-based discovery.
Built with pi-mono (@mariozechner/pi-agent-core + @mariozechner/pi-ai), the same toolkit that powers OpenClaw.
Free to run — defaults to OpenAI's GPT-OSS 120B on Groq. Swap to any provider with a flag.
git clone https://github.com/mager/temporal.git
cd temporal
npm install
npm run buildGet a free API key at console.groq.com:
export GROQ_API_KEY=gsk_...
npm start♫ ♪ ♬ T E M P O R A L
─────────────────────────────────
Your music-obsessed friend.
Ask me anything about music.
groq/openai/gpt-oss-120b
♩ has sam smith put out anything good lately?
♪ Sam Smith's "Unholy" with Kim Petras is still charting — sitting at 77
popularity on Spotify. It's in A minor at 131 BPM with 71% danceability,
basically a dark, groovy pop banger. Produced by Jimmy Napes and
Ilya Salmanzadeh...
https://open.spotify.com/track/3nqQXoyQOWXiESFLlDF1hG
The agent chains these tools automatically to build rich, deep answers:
| Tool | Description |
|---|---|
beatbrain_discover | Live ranked discover feed from all 5 sources with Spotify links |
beatbrain_search | Search Spotify for artists, songs, or queries with popularity scores |
beatbrain_track | Deep track analysis: instruments, production credits, songwriting, key, BPM, danceability, energy |
beatbrain_creator | Artist/creator profiles: genres, origin, active years, top tracks, credits, external links |
beatbrain_genre | Genre-based discovery: find popular tracks in any genre |
The agent chains tools automatically — ask about a song and it'll search, pull the full track analysis, and talk about who produced it, what key it's in, and why it bangs.
Usage: temporal [options]
Options:
-p, --provider <name> LLM provider (default: groq)
-m, --model <name> Model name (default: gpt-oss-120b)
-h, --help Show this help
| Env Var | Default | Description |
|---|---|---|
GROQ_API_KEY | — | Groq API key (free) |
GEMINI_API_KEY | — | Google AI Studio key (free) |
OPENAI_API_KEY | — | OpenAI API key |
ANTHROPIC_API_KEY | — | Anthropic API key |
BEATBRAIN_PROVIDER | groq | Override default provider |
BEATBRAIN_MODEL | openai/gpt-oss-120b | Override default model |
temporal -p google -m gemini-2.0-flash
temporal -p anthropic -m claude-sonnet-4-20250514
temporal -p openai -m gpt-4oTemporal uses @mariozechner/pi-agent-core to create a stateful agent with five custom tools (the "context brain"). The agent maintains conversation context across turns, streams responses token-by-token with a typewriter effect, and chains multiple tools to build rich answers.
The default model is GPT-OSS 120B on Groq — OpenAI's open-weight MoE model (120B total / 5.1B active parameters, Apache 2.0) with native tool use and configurable reasoning effort, running at 500 tokens/sec. Since pi-ai abstracts the provider, you can swap to Llama, Gemini, Claude, or any other supported model with a single flag.
- Agent Runtime: @mariozechner/pi-agent-core — stateful agent loop with tool execution
- LLM API: @mariozechner/pi-ai — unified multi-provider LLM interface
- Data: BeatBrain API (Go backend on Cloud Run) + Spotify + MusicBrainz
Read the full writeup: Building a Music Agent CLI with pi-mono
MIT