How william-hon/mnemo works
MNEMO is a cross-platform, privacy-first journal and memory retrieval app. Users authenticate, unlock or set up encryption, then create text or voice entries; the client encrypts journal text before storage. Voice transcripts and entries are processed into embeddings for hybrid search, while retrieved memories can ground on-device local-LLM chat. History supports search and deletion; settings manage encryption and the local model, and admin screens handle failed processing. The README documents backend and model-hosting capabilities not fully visible in sampled source; those links are cited to it rather than inferred from imports.
Main entry points: entries.ts Entry service · transcribe/index.ts Transcription function · process-entry/index.ts Entry processing · LocalAIService.ts Local AI runtime
Components 23
Client experience
- Sign-in and recovery
app/(auth)/recovery.tsx - Journal capture
app/(tabs)/home.tsx - History and search
app/(tabs)/history.tsx - Settings and model
app/(tabs)/settings.tsx - Processing admin
app/(tabs)/admin.tsx
Privacy and entries
- Auth state
src/providers/AuthProvider.tsx - Client encryption
src/lib/encryption.ts - Entry service
src/services/entries.ts - Audio capture
src/services/audio.ts - Audio storage
src/services/media.ts
Memory and local AI
- Entry processing
supabase/functions/process-entry/index.ts - Vector search function
supabase/functions/search-entries/index.ts - Edge encryption
supabase/functions/shared/encryption.ts - Local AI runtime
src/services/LocalAIService.ts
Cloud services
- Supabase client
src/lib/supabase.ts - Postgres and storage
- Transcription function
supabase/functions/transcribe/index.ts - Model download sessions
supabase/functions/private-ai-download-url/index.ts - Download completion
supabase/functions/complete-private-ai-download/index.ts - Account deletion
supabase/functions/delete-account/index.ts
Other components
- Journal user
- Groq Whisper
- Cloudflare R2
Connections 31
- Journal user → Sign-in and recovery: signs in
- Sign-in and recovery → Auth state: establishes session
src/providers/AuthProvider.tsx - Sign-in and recovery → Client encryption: sets up keys
app/(auth)/recovery.tsx - Journal capture → Entry service: saves text
app/(tabs)/home.tsx - Journal capture → Audio capture: captures voice
app/(tabs)/home.tsx - Journal capture → Audio storage: uploads audio
app/(tabs)/home.tsx - Entry service → Client encryption: encrypts and decrypts
src/services/entries.ts - Entry service → Supabase client: reads and writes
src/services/entries.ts - Audio storage → Supabase client: stores audio
src/services/media.ts - History and search → Entry service: lists searches deletes
app/(tabs)/history.tsx - History and search → Local AI runtime: asks about memories
app/(tabs)/history.tsx - Processing admin → Entry service: retries processing
app/(tabs)/admin.tsx - Settings and model → Local AI runtime: manages model
app/(tabs)/settings.tsx - Settings and model → Client encryption: manages encryption
app/(tabs)/settings.tsx - Supabase client → Postgres and storage: connects to
- Entry service → Transcription function: invokes transcription
src/services/entries.ts - Entry service → Entry processing: invokes indexing
src/services/entries.ts - Entry service → Vector search function: invokes vector search
src/services/entries.ts - Transcription function → Groq Whisper: transcribes audio
- Transcription function → Edge encryption: encrypts transcript
supabase/functions/transcribe/index.ts - Transcription function → Entry processing: triggers indexing
- Entry processing → Edge encryption: decrypts and encrypts
supabase/functions/process-entry/index.ts - Entry processing → Postgres and storage: writes embeddings
- Vector search function → Postgres and storage: queries vectors
- Entry service → Postgres and storage: stores encrypted entries
- Local AI runtime → Model download sessions: requests signed URL
- Model download sessions → Cloudflare R2: signs model URL
- Local AI runtime → Download completion: completes session
src/services/LocalAIService.ts - Download completion → Postgres and storage: marks session complete
- Journal user → Account deletion: requests account deletion
- Account deletion → Postgres and storage: cascades user data