RESONATE FANS BRING THE SHOW • ON-CHAIN AUDIO IP Programmable Stems • Human Studio • x402 Commerce • MCP Server
🚧 Work in Progress. This is an experimental project under active development. Not production-ready.
Resonate is a music platform for independent artists and the professionals who work with their music: DJs, producers and creators. Artists release music, sell licenses to use it, and fund shows with their fans. Professionals find rights-clear music and license it in one step. Listeners get a full music app whose recommendations are never for sale. AI agents reach the same catalog over MCP and x402, always through a priced quote and a signed receipt.
The human studio, storefront API, x402 payment flow, and MCP interface are peers over the same on-chain catalog. Four audiences, one catalog:
- Artists: upload releases, price each license tier (personal / remix / commercial), run escrow-backed Shows campaigns with their fans, and keep at least 85% of every sale.
- DJs, producers and creators: license stems and tracks with clear terms, remix in Remix Studio, and export what they licensed.
- Listeners: player, library, playlists, discovery with readable reasons, Shows and collectibles. Wallet-native purchases. You own what you buy.
- Agents: storefront endpoints, licensing-aware quotes, x402 HTTP payments, machine-readable purchase receipts. No account required.
The direction is set by the business model review and the taste engine decisions.
- Resonate Shows: escrow-backed fan campaigns that turn city-level demand into booking signals · Shows
- Licensed stems: every track split into six stems (vocals, drums, bass, guitar, piano, other) and sold as personal, remix or commercial licenses; official artist stems are proposed in ADR-TE-7 · Upload flow
- Marketplace: on-chain license sales with stablecoin settlement · Contracts
- Remix Studio: licensed remixing, with AI parts billed in credits · Remix Studio
- Taste engine: one recommendation framework behind the listener AI DJ, the planned Crate Digger for DJs and Scene Scout for artists, with public rules enforced from Vision Sprint 28: no paid ranking, and no agent spends without an approved quote · Taste intelligence
- x402 commerce: machine-to-machine license purchases over HTTP with USDC settlement and structured receipts · x402 payments
- MCP tools:
catalog.search,stem.quote,stem.downloadover Streamable HTTP at/mcp· MCP server - Smart accounts: ERC-4337 Kernel accounts with session keys for gasless UX · Account abstraction
- Community curation: dispute flows and curator-resolved content quality signals · Curation
See the feature catalog for the full index of implemented, partial, planned, and retired capabilities.
Resonate deploys as a full-stack music and agent-commerce system: Cloud Run services, Pub/Sub pipelines, Cloud SQL, Redis, GCS, ERC-4337 smart accounts, and a Terraform-managed GCP edge. Ordinary CI validates source; an explicit exact-SHA Release Deployment publishes immutable images and can hand their digest manifest to resonate-iac for infrastructure reconciliation.
→ Application architecture · Deployment architecture · Click a diagram to open it full size.
For the full development setup guide with detailed explanations, see Getting Started.
| Tool | Install |
|---|---|
| Node.js 22.12+ | nodejs.org or nvm install 22 |
| Docker | docker.com/get-started |
| Make | Pre-installed on macOS/Linux; Windows: use WSL |
| Foundry (contracts) | getfoundry.sh |
# Install dependencies
npm install -g npm@11.14.1
cd contracts && ./scripts/install-deps.sh
cd ../backend && npm ci
cd ../web && npm ci --legacy-peer-deps
cd ../desktop && npm ci
cd ..
# Start infrastructure + worker + chain fork + contracts
export SEPOLIA_RPC_URL=https://sepolia.drpc.org
make dev-up
make worker-gpu
make local-aa-fork
make deploy-contracts
# Start services (separate terminals)
make backend-dev # NestJS API on port 3000
make web-dev-fork # Next.js on port 3001 (chain 11155111, local RPC)make dev-up
make worker-gpu
make contracts-deploy-local
make backend-dev # port 3000
make web-dev-local # port 3001 (chain 31337)make db-reset # Reset database
make dev-down # Stop Postgres, Redis, Pub/Sub, Demucs worker
make local-aa-down # Stop Anvil + Alto| Document | Description |
|---|---|
| User Guide | In-app manual at /help — how to use Resonate (all personas) |
| Getting Started | Full development setup guide |
| Feature Catalog | Index of all platform capabilities |
| Project Specification | Vision, architecture, and roadmap |
| Deployment Architecture | GCP, smart accounts, blockchain, x402 topology |
| Environment Variables | App runtime and provider configuration |
| Local AA Development | Account abstraction setup |
| Demucs Worker | GPU stem separation setup |
| x402 Payments | Machine-to-machine stem purchases |
| MCP Server | Agent tool discovery and setup |
| Core Contracts | Stem NFT and marketplace contracts |
| Troubleshooting | Common issues and fixes |
| Contributing | Contribution guidelines |
| Layer | Technology |
|---|---|
| Frontend | Next.js 16, React 19, Zustand, Viem, ZeroDev (ERC-4337 passkeys), Electron (desktop shell) |
| Backend | NestJS, Prisma, BullMQ, Socket.IO, GCP Pub/Sub, PostgreSQL |
| Agents | MCP server, OpenAPI storefront, x402 payments, Google ADK (AI DJ runtime) |
| Blockchain | Solidity, Foundry, ERC-4337, ZeroDev, x402 |
| AI | Demucs (htdemucs_6s), Stable Audio 3 (self-hosted, GPU), Vertex AI (Lyria, Gemini) |
| Analytics | Apache Beam (Dataflow), BigQuery, Dataform |
| Infrastructure | Docker, Redis, GCP Pub/Sub, Cloud Run, GitHub Actions, Terraform (managed in resonate-iac) |
MIT © 2024-2026