git404hub

what is riff fr?

abhi-arya1/riff — explained in plain English

Analysis updated 2026-05-18

13TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

tl;dr

An early demo voice assistant for the car that controls Spotify hands free and hands more complex tasks off to a separate AI agent.

vibe map

mindmap
  root((Riff))
    What it does
      Voice controls Spotify
      Routes complex tasks to Pi
      Local preference memory
    Tech stack
      TypeScript
      Bun runtime
      OpenAI Realtime
    Use cases
      Hands free playback
      Playlist recommendations
      Optional Tesla comfort control
    Audience
      Developers
      Car tinkerers
    Setup
      macOS required
      Bun and Pi CLI
      API keys needed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Control Spotify playback hands free in a car using voice commands.

VIBE 2

Delegate more complex music tasks like recommendations and playlist work to a background AI agent.

VIBE 3

Optionally control limited Tesla media and cabin comfort features over Bluetooth while parked.

what's the stack?

TypeScriptBunWebRTCOpenAI RealtimeSpotify CLI

how it stacks up fr

abhi-arya1/riffandersondanieln/hexllamaantonlobanovskiy/agent-tmux-web
Stars131313
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires macOS, Studio by Spotify Labs, a Pi-compatible agent CLI, and separate OpenAI and Vercel API keys.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Riff is an early stage voice assistant meant to sit in a car and control Spotify hands free, built to run on a laptop rather than as a packaged product. It listens through a browser using a real time voice connection from OpenAI, can interrupt itself naturally the way a person would in conversation, and remembers explicit preferences a user tells it to keep. The author describes it as a demo project that expects the person running it to already have their own accounts, API keys, and command line tools set up. Simple playback commands like pause, resume, skip, checking what is playing, and adjusting volume go straight to Spotify through a short direct path. More involved requests, such as getting recommendations, working with playlists, looking at listening history, or doing live web research, get handed off to a separate coding agent called Pi, which is given a fixed and limited set of tools rather than open access to the file system or network. Explicit preferences and named listening routines get saved to a local memory system, while secrets, exact locations, routine playback actions, and full conversation transcripts are deliberately left out of that memory. Riff also has optional support for controlling a small set of Tesla features over Bluetooth, limited to things like media volume, climate, cabin temperature, and seat or steering wheel heating. It explicitly does not touch locks, doors, the trunk, driving, charging, navigation, keys, or security settings, and the README is firm that any Tesla pairing or setup should only be done while the car is parked. Setting it up currently requires a Mac, the Bun JavaScript runtime, a Pi compatible coding agent on the command line, the Studio by Spotify Labs application along with its bundled command line tool, an OpenAI API key, and a Vercel AI Gateway key. None of those third party applications or accounts are included in the repository itself. The project states it is not affiliated with Spotify, Tesla, OpenAI, Vercel, Pi, or Supermemory, and it is released under the MIT license.

prompts (copy fr)

prompt 1
Help me set up Riff's .env file with the required OpenAI and Vercel AI Gateway keys.
prompt 2
Walk me through pairing Riff with a Tesla vehicle using tesla-control and tesla-keygen.
prompt 3
Explain how Riff routes a voice request between direct Spotify commands and the Pi agent.
prompt 4
Show me how Riff's local Supermemory instance decides what preferences to save.

Frequently asked questions

what is riff fr?

An early demo voice assistant for the car that controls Spotify hands free and hands more complex tasks off to a separate AI agent.

What language is riff written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, WebRTC.

What license does riff use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is riff to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is riff for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.