How dsk-dev-ai/genomeai works
GenomeAI is an AI-augmented biomedical research platform: researchers use its web interface or API to request biological data and analyses, which can draw on public scientific sources and return results for exploration and visualization. Its runtime also includes a DAG workflow engine with queued execution, retries, and scheduling. The README documents the major capabilities; sampled source confirms API setup, workflow execution, and parts of the visualization data lifecycle. Several subsystem links are therefore documented at a high level rather than verified call-by-call.
Main entry points: main.py REST API · page.tsx Web Research UI · gene_analysis.py AI Analysis · genes.py Domain Endpoints
Components 23
User Interfaces
- Web Research UI
apps/web/src/app/research/page.tsx - Python SDK
packages/sdk-python/src/genomeai_sdk/client.py - Scientific Visualizations
apps/web/src/components/scientific - Genome Browser
apps/web/src/components/genome/GenomeBrowser.tsx - Protein Viewer
apps/web/src/components/protein/ProteinViewer.tsx - Network Graphs
apps/web/src/components/network/NetworkViewer.tsx
API and Analysis
- REST API
apps/api/src/genomeai_api/main.py - AI Analysis
apps/api/src/genomeai_api/services/gene_analysis.py - Domain Endpoints
apps/api/src/genomeai_api/routes/genes.py - Workflow Endpoints
apps/api/src/genomeai_api/routes/workflows.py
Research Data
- Scientific Connectors
apps/api/src/genomeai_api/integration/connectors - Public Data Sources
- Biological Models
apps/api/src/genomeai_api/models/gene.py - Data Repositories
apps/api/src/genomeai_api/repositories/gene.py - Gemini and Ollama
apps/api/src/genomeai_api/ai
Workflow Orchestration
- DAG Execution
apps/api/src/genomeai_api/workflows/execution/engine.py - Run Worker
apps/api/src/genomeai_api/services/worker.py - Redis Queue
apps/api/src/genomeai_api/workflows/queueing.py - Workflow Scheduler
apps/api/src/genomeai_api/services/scheduler.py
Runtime Platform
- PostgreSQL
apps/api/src/genomeai_api/database/engine.py - Redis Cache
apps/api/src/genomeai_api/cache/redis.py
Other components
- Researcher
- LLM Providers
Connections 24
- Researcher → Web Research UI: requests research
README.md - Web Research UI → REST API: calls API
README.md - Python SDK → REST API: calls API
- REST API → Domain Endpoints: registers routes
apps/api/src/genomeai_api/main.py - REST API → Workflow Endpoints: registers routes
apps/api/src/genomeai_api/main.py - Domain Endpoints → AI Analysis: requests analysis
- AI Analysis → Scientific Connectors: retrieves evidence
README.md - Scientific Connectors → Public Data Sources: queries databases
README.md - AI Analysis → Gemini and Ollama: uses models
README.md - Gemini and Ollama → LLM Providers: sends prompts
README.md - Domain Endpoints → Data Repositories: persists data
- Data Repositories → PostgreSQL: reads and writes
- Data Repositories → Biological Models: uses models
- REST API → DAG Execution: supports workflows
README.md - Workflow Endpoints → Redis Queue: enqueues runs
README.md - Redis Queue → Run Worker: claims jobs
README.md - Run Worker → DAG Execution: executes runs
apps/api/src/genomeai_api/services/worker.py - DAG Execution → PostgreSQL: records run state
- Workflow Scheduler → Redis Queue: schedules runs
README.md - REST API → Redis Cache: initializes cache
apps/api/src/genomeai_api/main.py - AI Analysis → Scientific Visualizations: returns analysis results
README.md - Web Research UI → Genome Browser: presents genome data
README.md - Web Research UI → Protein Viewer: presents protein data
README.md - Web Research UI → Network Graphs: presents networks
README.md