Lyre

Audio recording management and transcription platform
Upload · Transcribe · Explore

---

Features

• Audio Upload — Direct-to-OSS presigned upload with progress tracking (up to 500 MB)
• ASR Transcription — Aliyun DashScope async job, polled by a Cloudflare Cron Trigger
• AI Summaries — Multi-provider LLM summarization (OpenAI, Anthropic) with streaming markdown
• Audio Player — Custom player with play/pause, skip, variable speed, and progress seeking
• Transcript Viewer — Sentence view synced to playback, full-text view, one-click copy
• Word-Level Karaoke — Lazy-loaded word timestamps, clickable words for seeking, real-time highlighting
• Recording Management — CRUD, search, folders, tags, status filter, pagination, and sorting
• Dashboard — Charts and statistics for recording activity overview
• Cloudflare Access SSO — Email-based access control enforced at the edge
• Cloudflare D1 — Serverless SQLite store managed entirely on the Cloudflare edge
• Remote Backup — Bidirectional Backy integration (push + pull webhook)
• macOS App — Native Swift/SwiftUI menu bar app for meeting recording (mic + system audio)

Architecture

                ┌──────────────────────────────────────────┐
   Browser ───▶ │ Cloudflare Access (SSO + JWT)            │
                ├──────────────────────────────────────────┤
                │ Worker `lyre-api`  (apps/api)            │
                │   • Hono router                          │
                │   • Static SPA via [assets] (apps/web)   │
                │   • D1 binding `DB`                      │
                │   • Cron Trigger → ASR poll              │
                └──────────────────────────────────────────┘
                         │              │
                         ▼              ▼
                   Aliyun OSS    Aliyun DashScope
                   (audio blobs)  (qwen3-asr-flash)

• apps/web — Vite SPA, served as static assets by the Worker.
• apps/api — Hono Worker entry, middleware (Access JWT, bearer token), and route adapters.
• packages/api — Framework-agnostic handlers, services, repos, contracts (@lyre/api).
• apps/macos — Native menu bar recorder that uploads via the Worker API.

Quick Start

1. Install dependencies

# Requires Bun: https://bun.sh
bun install

Supply-chain hardening — trusted dependencies. Bun does not run npm lifecycle scripts (preinstall / install / postinstall / prepare) for dependencies by default. This repo's package.json declares an explicit trustedDependencies allow-list, which replaces Bun's built-in 367-package default list — only packages on this short list are permitted to execute install scripts. Current entries:

• better-sqlite3 — fetches the prebuilt native binding used by the in-memory test DB.
• husky — installs the local git hooks declared in .husky/.

Trusted fallback procedure. If a new dependency genuinely needs to run an install script (typical case: a package shipping a prebuilt native binding), add it to trustedDependencies in the same PR that introduces the dependency. Reviewers must inspect the package's install script and confirm it is not an attack vector before approving. Packages omitted from the list silently skip their lifecycle scripts — confirm via bun pm untrusted after install.

2. Configure environment variables

The Worker reads its config from Wrangler (apps/api/wrangler.toml + secrets). The Vite SPA only needs the API origin at build time.

See docs/01-deployment.md for the full list of Cloudflare bindings (D1, vars, secrets) and how to provision them.

3. Local development

# Vite SPA (web UI)
bun run web:dev

# Hono Worker against a local D1 (separate terminal)
bun run worker:dev

4. Deploy

# Build the SPA into apps/web/dist, then publish the Worker
bun run deploy        # production
bun run deploy:test   # staging environment

Project Structure

lyre/
├── apps/
│   ├── web/        Vite SPA (@lyre/web) — bundled into the Worker as static assets
│   ├── api/        Hono Worker (@lyre/api-worker) — entry, middleware, routes, cron
│   └── macos/      Native Swift/SwiftUI menu bar app
├── packages/
│   └── api/        @lyre/api — handlers, services, repos, contracts (framework-agnostic)
├── docs/
└── package.json    Bun workspaces root

Tech Stack

Layer	Technology
Runtime	Bun (dev/build), Cloudflare Workers (prod)
Web	Vite 7 + React 19 + TypeScript 5
API	Hono 4 on Cloudflare Workers
Database	Cloudflare D1 (SQLite) via Drizzle ORM
UI	shadcn/ui + Radix UI + Tailwind CSS v4
Auth	Cloudflare Access (web) + bearer device tokens (macOS)
AI	Vercel AI SDK (OpenAI + Anthropic)
Storage	Aliyun OSS (zero-SDK, custom V1 signature)
ASR	Aliyun DashScope (qwen3-asr-flash-filetrans)
Job polling	Cloudflare Cron Trigger → cronTickHandler
Deploy	Wrangler (bun run deploy)

Common Commands

Command	Description
bun run web:dev	Start the Vite SPA dev server
bun run worker:dev	Start the Hono Worker locally (Wrangler)
bun run lint	Lint web + @lyre/api
bun run typecheck	Typecheck web + worker + @lyre/api
bun run test	Unit tests for web + worker + @lyre/api
bun run test:coverage	@lyre/api coverage gate
bun run deploy	Build SPA + publish Worker to production
bun run deploy:test	Build SPA + publish Worker to staging

License

MIT © 2026