Duetto is a self-hostable music player for two people with an AI companion that listens to the audio stream and grows a memory of shared songs and conversations.

Stars

49

7-day growth

No data

Forks

14

Open issues

0

License

MIT

Last updated

2026-07-04

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It uniquely combines real-time synchronized music playback with an AI that actually processes the audio stream (not just metadata) and builds persistent, personal memories around songs, all while being self-hosted with strong privacy and security features.

Who it is for

  • Couples or close friends who want to listen to music together remotely
  • Self-hosting enthusiasts looking for a unique, privacy-respecting media experience
  • Users of NetEase Cloud Music who want a shared listening and AI commentary layer
  • Developers interested in a full-stack React + WebSocket + AI integration project

Use cases

  • Synchronized music listening in real time with a partner over WebSocket
  • Discussing lyrics with an AI that understands the exact song context and remembers past conversations
  • Building a shared, searchable archive of song reactions and memories
  • Exploring NetEase playlists and daily recommendations with a companion that learns your taste

Strengths

  • Real audio playback synced across rooms with prefetching and WebSocket
  • AI that actually listens to the audio stream using a multimodal model and caches analyses forever
  • Built-in PIN gate for access control, with token-based auth and HTTPS recommendation
  • Deep customization: 5 palette skins, wallpaper, bubble colors, lyric fonts, and two reply styles

Considerations

  • Requires Node 24+ due to use of built-in SQLite
  • Security is a single-secret PIN gate, not a full multi-user authentication system
  • AI functionality depends on an external OpenAI-compatible endpoint and a separate analysis model optional

README quick start

Quick start

Description

Duetto — self-hostable listen-together player for two, with an AI companion that actually listens. 可自部署的双人一起听歌播放器,AI 真的听过你们的每一首歌。

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
tandpfun
Featured
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
Featured
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents
1,234