How frosty-mug/umbrella works
Umbrella OS combines a windowed desktop for genomic research with a FastAPI compute backend. Users open scientific apps, select or upload samples, inspect sequence quality and resistance findings, explore cohort analytics or simulations, and use research and reporting tools; backend routes expose authentication, persistence, analysis, and AI orchestration. The README documents additional app capabilities not present in sampled source, which are represented at their app-directory paths. Some subsystem links rely on README claims or the source index rather than inspected implementations.
Main entry points: page.tsx Desktop Shell · main.py FastAPI Service · train_baseline.py Model Training · store.ts Window and Sample State
Components 28
Desktop OS
- Desktop Shell
apps/desktop/app/page.tsx - Window and Sample State
apps/desktop/lib/store.ts - Windowing and Launcher
apps/desktop/components/desktop - Clearance Login
apps/desktop/components/BiotechLoginModal.tsx
Research Apps
- Genome Analysis Apps
apps/desktop/apps/GenomeAnalyzerApp.tsx - Genome Competitor
apps/desktop/apps/GenomeCompetitorApp.tsx - Sequence QC
apps/desktop/apps/SequenceQCApp.tsx - Sample Vault
apps/desktop/apps/SampleVaultApp.tsx - Cohort Analytics
apps/desktop/apps/AnalysisStudioApp.tsx - Stress Simulators
apps/desktop/apps/StressLabApp.tsx - Science Lab
apps/desktop/apps/ScienceLabApp.tsx - Research Desk
apps/desktop/apps/ResearchDeskApp.tsx - Bio-Terminal
apps/desktop/apps/BioTerminalApp.tsx - Reports and Export
apps/desktop/apps/ReportStudioApp.tsx - Vella Assistant
apps/desktop/apps/VellaApp.tsx
API Services
- FastAPI Service
services/api/main.py - Authentication and Roles
services/api/auth_router.py - Database and Domain Records
services/api/database.py - AMR Training API
services/api/amr_pipeline_router.py - Competitor and Stress APIs
services/api - Vella Orchestrator
services/vella/orchestrator.py
Bioinformatics
- FASTA Parsing and QC
core/bio/fasta_parser.py - AMR Annotation
core/bio/amrfinder.py
AMR Modeling
- AMR Feature Extraction
ml/features/extractor.py - Model Training
ml/training/train_baseline.py - Model Registry
ml/registry/model_store.py
Other components
- Researcher
- AI Model Providers
Connections 34
- Researcher → Desktop Shell: opens desktop
- Desktop Shell → Windowing and Launcher: renders windows
apps/desktop/app/page.tsx - Desktop Shell → Window and Sample State: reads window state
apps/desktop/app/page.tsx - Desktop Shell → Clearance Login: renders clearance
apps/desktop/app/page.tsx - Window and Sample State → Windowing and Launcher: tracks window state
apps/desktop/components/desktop/WindowFrame.tsx - Desktop Shell → Genome Analysis Apps: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Genome Competitor: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Sequence QC: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Sample Vault: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Cohort Analytics: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Stress Simulators: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Science Lab: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Research Desk: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Bio-Terminal: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Reports and Export: dispatches app
apps/desktop/app/page.tsx - Desktop Shell → Vella Assistant: dispatches app
apps/desktop/app/page.tsx - Researcher → Sample Vault: selects sample
- Researcher → Sequence QC: uploads FASTA
- FastAPI Service → FASTA Parsing and QC: runs sequence QC
services/api/main.py - FastAPI Service → Database and Domain Records: persists records
services/api/main.py - FastAPI Service → Authentication and Roles: mounts routes
services/api/main.py - FastAPI Service → AMR Training API: mounts routes
services/api/main.py - FastAPI Service → Competitor and Stress APIs: mounts routes
services/api/main.py - FastAPI Service → Vella Orchestrator: dispatches requests
services/api/main.py - FASTA Parsing and QC → AMR Annotation: provides sequence input
- AMR Annotation → AMR Feature Extraction: provides annotations
ml/features/extractor.py - Model Training → AMR Feature Extraction: extracts features
ml/training/train_baseline.py - AMR Training API → Authentication and Roles: checks role
services/api/amr_pipeline_router.py - Vella Orchestrator → AI Model Providers: requests AI response
services/vella/orchestrator.py - Researcher → Cohort Analytics: explores cohorts
- Researcher → Stress Simulators: runs simulations
- Researcher → Research Desk: records investigation
- Researcher → Reports and Export: exports dossier
- Model Training → Model Registry: registers models