Reach — Audio-Aware Multi-Tenant Community Platform

Reach is a polyglot monorepo for a production-grade, audio-aware multi-tenant community platform. It integrates four tightly coupled services: a Buzz multi-tenant Nostr relay (Rust), an NVIDIA Audio Flamingo inference service (Python), a Google CES/CX Agent Studio web widget (TypeScript), and an API orchestration gateway (TypeScript).

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        User / Browser                           │
└───────────────────────────┬─────────────────────────────────────┘
                            │ HTTPS / WebSocket
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│              widget/ — Google CES Web Widget (TS)               │
│         chat | voice | mixed modality (VITE_MODALITY)           │
└───────────────────────────┬─────────────────────────────────────┘
                            │ REST + WS
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│           api/ — Orchestration Gateway (TypeScript)             │
│   /api/chat  /api/audio  /api/token  /health                    │
└──────────┬──────────────────────────┬───────────────────────────┘
           │ NIP-01 WebSocket         │ HTTP multipart
           ▼                          ▼
┌──────────────────────┐   ┌──────────────────────────────────────┐
│  relay/ — Buzz Relay │   │  audio/ — Audio Flamingo Service     │
│  (Rust / Axum)       │   │  (Python / FastAPI)                  │
│  NIP-01/42/98        │   │  AF3 | AF2 | Music Flamingo          │
│  PostgreSQL + RLS    │   │  NVIDIA CUDA inference               │
└──────────────────────┘   └──────────────────────────────────────┘
           │
           ▼
┌──────────────────────┐
│  PostgreSQL 16       │
│  Multi-tenant RLS    │
│  Audit chains        │
└──────────────────────┘

Quick Start

cp .env.example .env
# Edit .env with your credentials
docker-compose up

Services

Documentation

• Architecture
• Formal Spec Notes

License

MIT