mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-15 01:21:09 +02:00
Mirror of github.com/Memo-2023/mana-monorepo
Integrate new transcriber application for AI-powered YouTube video
transcription with full monorepo structure and Groq Whisper API support.
## App Structure
- apps/transcriber/apps/backend - NestJS API server (port 3006)
- apps/transcriber/apps/web - SvelteKit web application
- apps/transcriber/apps/landing - Astro marketing/content site
- apps/transcriber/apps/mobile - Expo React Native app
- apps/transcriber/packages/shared-types - Shared TypeScript types
## Backend Features
- YouTube video download via yt-dlp (child_process)
- Ultra-fast transcription via Groq Whisper API (~300x realtime)
- Fallback to local Whisper for offline use
- Job queue with background processing
- Real-time progress updates via WebSocket (Socket.io)
- Playlist management for batch processing
- Health check endpoints
## API Endpoints
- POST /transcription - Start transcription job
- GET /transcription - List all jobs
- GET /transcription/:id - Get job status
- DELETE /transcription/:id - Cancel job
- GET /transcription/stats - Statistics
- GET /whisper/models - Available models
- GET/POST/DELETE /playlist - Playlist management
- GET /health - Health checks
## Whisper Models
- Groq: whisper-large-v3-turbo (fast, $0.04/hr)
- Groq: whisper-large-v3 (accurate, $0.111/hr)
- Local: tiny, base, small, medium, large
## Monorepo Integration
- Added to pnpm workspace via apps/*/apps/* pattern
- Root scripts: transcriber:dev, dev:transcriber:*
- Package naming: @transcriber/{backend,web,landing,mobile}
- Turbo tasks: dev, build, lint, type-check
- CLAUDE.md documentation
## Technology Stack
- Backend: NestJS 10, TypeScript, Socket.io
- Web: SvelteKit 2, Svelte 5, Tailwind CSS
- Landing: Astro 4, Solid.js, Tailwind CSS
- Mobile: Expo 52, React Native, NativeWind, Zustand
- Transcription: Groq Whisper API (OpenAI-compatible)
## Migration from Python
- Original Python/FastAPI code preserved in legacy/
- Full rewrite to TypeScript/NestJS
- Same functionality with improved architecture
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
||
|---|---|---|
| .claude/plans | ||
| .claude-flow/metrics | ||
| .hive-mind | ||
| apps | ||
| docker/init-db | ||
| docs | ||
| packages | ||
| scripts | ||
| services/mana-core-auth | ||
| .dockerignore | ||
| .editorconfig | ||
| .env.development | ||
| .env.example | ||
| .gitignore | ||
| .nvmrc | ||
| .prettierignore | ||
| .prettierrc | ||
| CLAUDE.md | ||
| docker-compose.dev.yml | ||
| docker-compose.yml | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| QA_TESTING_CHECKLIST.md | ||
| README.md | ||
| TEST_CASES_SAMPLES.md | ||
| TESTING_STRATEGY_AUTH_CREDITS.md | ||
| TESTING_STRATEGY_EXECUTIVE_SUMMARY.md | ||
| turbo.json | ||
Manacore Monorepo
Monorepo containing all Manacore projects with shared packages and unified tooling.
Projects
| Project | Description | Tech Stack |
|---|---|---|
| maerchenzauber | AI-powered story generation app | NestJS, Expo, SvelteKit, Astro |
| manacore | Multi-app ecosystem platform | Expo, SvelteKit, Astro |
| manadeck | Card/deck management app | NestJS, Expo, SvelteKit |
| memoro | Voice memo & AI analysis app | Expo, SvelteKit, Astro |
Getting Started
Prerequisites
- Node.js 20+
- pnpm 9.15.0+
Installation
# Install pnpm globally (if not installed)
npm install -g pnpm
# Install all dependencies
pnpm install
Development
# Start all projects in dev mode
pnpm run dev
# Start a specific project
pnpm run maerchenzauber:dev
pnpm run manacore:dev
pnpm run manadeck:dev
pnpm run memoro:dev
# Build all projects
pnpm run build
# Run tests
pnpm run test
# Type check
pnpm run type-check
# Format code
pnpm run format
Shared Packages
Located in packages/:
| Package | Description |
|---|---|
@manacore/shared-types |
Common TypeScript types |
@manacore/shared-supabase |
Unified Supabase client |
@manacore/shared-utils |
Utility functions (date, string, async) |
@manacore/shared-ui |
React Native UI components |
Using Shared Packages
// In any project
import { User, ApiResponse } from '@manacore/shared-types';
import { createSupabaseClient } from '@manacore/shared-supabase';
import { formatDate, truncate, retry } from '@manacore/shared-utils';
Repository Structure
manacore-monorepo/
├── packages/ # Shared packages
│ ├── shared-types/ # TypeScript types
│ ├── shared-supabase/ # Supabase utilities
│ ├── shared-utils/ # Common utilities
│ └── shared-ui/ # React Native components
├── maerchenzauber/ # Storyteller project
├── manacore/ # Manacore apps project
├── manadeck/ # ManaDeck project
├── memoro/ # Memoro project
├── turbo.json # Turborepo configuration
├── pnpm-workspace.yaml # Workspace configuration
└── package.json # Root package
Tooling
- Package Manager: pnpm 9.15.0
- Build System: Turborepo
- Formatting: Prettier
- Node Version: 20 (see .nvmrc)
Adding Dependencies
# Add to root (dev tools)
pnpm add -D <package> -w
# Add to specific project
pnpm add <package> --filter maerchenzauber
# Add to shared package
pnpm add <package> --filter @manacore/shared-utils
Contributing
- Create a feature branch
- Make changes
- Run
pnpm run formatandpnpm run type-check - Commit with conventional commit messages
- Create pull request
License
Private - All rights reserved