The backend is a super-repo: git clone --recurse-submodules pulls every service in
as a git submodule pinned to a tracked branch (mostly staging). The authoritative list is
.gitmodules; this table mirrors it. All repos
live under the soundversegit org.
~31 submodules — the count grows; when in doubt,
cat .gitmodules.
| Repo |
Lang |
Role |
Branch |
soundverse-proto |
multi |
Source of truth — proto contracts, SQL-in-proto, schema.sql, codegen |
staging |
soundverse-proto-go |
Go |
Generated Go SDK (published package; also a submodule mirror) |
staging |
soundverse-proto-python |
Py |
Generated Python SDK |
staging |
soundverse-proto-web |
TS |
Generated Connect-ES TS stubs for the frontends |
staging |
soundverse-proto-swift |
Swift |
Generated Swift SDK (mobile) |
staging |
soundverse-proto-kotlin |
Kotlin |
Generated Kotlin SDK (mobile) |
staging |
| Repo |
Lang |
Role |
Branch |
core-database |
Go |
The sole Postgres data plane (codegen’d Connect handlers) |
staging |
core-gateway-consumer |
Py |
Consumer trust boundary — authz, billing, streams |
staging |
core-gateway-studio |
Py |
Gateway for the in-browser studio surface |
staging |
core-gateway-enterprise |
Py |
Gateway for enterprise/API surface |
staging |
core-identity |
Py |
Logto token validation + JIT user provisioning |
staging |
core-mcp |
Go |
MCP tool registry for agents + second billing pipeline |
staging |
core-storage |
Py |
Blob storage, dedup, SAS, live-to-VOD transcode |
staging |
core-billing |
Py |
Payments/subscriptions (Stripe/PayU/IAP) |
staging |
core-migration |
Py |
1.0 → 2.0 user/billing/library migration |
staging |
core-manifest |
— |
Studio manifest service (studio composition recipes) |
staging |
core-redis |
— |
Shared Redis conventions/helpers |
staging |
| Repo |
Lang |
Role |
Branch |
core-tool-agent |
Py |
Agent One LLM worker (Claude + Kimi tiers) |
staging |
core-tool-sansaarm |
Py |
Sansaarm song/music generation |
staging |
core-tool-stitch |
Py |
Audio/video stitching + studio composition |
staging |
core-tool-media |
Py |
Album art & media generation |
staging |
core-tool-gpu |
Py |
Stem separation (htdemucs) — GPU-profile worker |
staging |
core-tool-dna |
Py |
DNA / voice-model tooling |
staging |
core-tool-copyright |
Py |
Copyright checks |
staging |
core-tool-allin1 |
Py |
Section analysis (allin1 on-box) |
main |
core-tool-distribution |
Py |
Distribution/publishing |
staging |
core-conversion |
Py |
ffmpeg/Pillow format conversion service |
staging |
template-core-tool |
Py |
Scaffold for a new tool worker |
staging |
| Repo |
Lang |
Role |
Branch |
soundverse-py |
Py |
Shared SDK — config, gRPC client, WorkerFleet, TaskContext, telemetry |
main |
soundverse-saas-2.0 |
Node |
The Next.js SaaS web app (SPA + BFF) |
staging |
UI2.0 |
Node |
Standalone in-browser music studio |
UI2.0NextJS |