Skip to content

Latest commit

Β 

History

193 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Live Demo GitHub Stars Forks

License CI Status Last commit Open issues PRs Welcome Sponsor

🧬 GenomeAI

Open-source AI platform for genomics, bioinformatics, biomedical research,
and evidence-based AI powered by public scientific databases and multi-provider LLMs.

GenomeAI banner

πŸš€ Live Demo

Try GenomeAI right now β€” no install required. Click the link and use the working application:

🌐 Open the Live Demo β†’ https://genomeai.vercel.app
Backend API: https://genomeai-api.onrender.com Β· free-tier hosts, deployed automatically on every release. See docs/deployment/releases.md for how it works.


What is GenomeAI?

GenomeAI is a unified platform that brings together public biological databases, workflow automation, data visualization, and AI-powered analysis β€” all in one open-source stack.

It connects directly to 18 free public APIs (NCBI, Ensembl, UniProt, ClinVar, gnomAD, PDB, AlphaFold, ChEMBL, PubChem, Reactome, KEGG, STRING, OpenTargets, Monarch, Disease Ontology, DGIdb, Europe PMC, Semantic Scholar) to give researchers instant access to genomic, proteomic, chemical, and clinical data β€” without expensive licenses or proprietary infrastructure.

Goal: Make biomedical research accessible, reproducible, and AI-augmented for every researcher, clinician, and developer β€” anywhere in the world.


Why GenomeAI?

Problem GenomeAI Solution
Biomedical data is scattered across 100+ databases Unified connector layer β€” one API for all sources
Existing tools require expensive licenses 100% open-source, runs on free-tier APIs
No integrated AI for genomic analysis Multi-provider LLM support (Gemini cloud, Ollama local)
Workflows are manual and error-prone DAG-based workflow engine with retry, scheduling, and parallel execution
Results are hard to visualize Built-in genome browser, protein viewer, network graphs, scientific charts
Reproducibility is difficult Versioned workflows, provenance tracking, audit logs

Features

Built and Working

Feature Status
Biological domain models (Genome, Sample, Gene, Variant, Transcript, Protein, …) βœ…
REST API with CRUD + enhanced analysis endpoints (24 route modules) βœ…
Workflow DAG engine (definitions, steps, dependencies, validation) βœ…
Deterministic, parallel DAG execution βœ…
Cron-based workflow scheduler βœ…
Queue & worker (Redis-backed background execution) βœ…
Retry & failure handling (classification, backoff, policies) βœ…
18 real external-data connectors (NCBI, UniProt, ClinVar, gnomAD, …) βœ…
AI-powered analysis (gene, variant, protein, drug, pathway, disease, literature, multi-domain report) with Gemini + Ollama βœ…
Genome browser, protein viewer, network graphs, scientific charts, molecular structure βœ…
Live demo β€” genomeai.vercel.app βœ…

Coming Next

Feature Phase
Knowledge graph (gene-disease-drug-protein associations) 5
More AI providers (OpenAI, Anthropic, Groq, Mistral) 6
PubMed/Europe PMC deep-dive literature QA 6
Plugin SDK and marketplace 7
Full-text ingestion workers (scheduled sync of source databases) 7
Authentication & multi-user organizations 8

Public Data Sources (Free APIs)

GenomeAI ships with 18 real connectors to free public databases (implemented, live, and tested):

Domain Sources
Genomic NCBI E-utilities, Ensembl (VEP)
Protein UniProt, RCSB PDB, AlphaFold DB
Drug/Compound ChEMBL, PubChem, DGIdb, Open Targets
Literature Europe PMC, Semantic Scholar
Pathway Reactome, KEGG
Network STRING
Variant ClinVar, gnomAD
Disease Disease Ontology, Monarch, Open Targets

See docs/data-integration/ for the live connectors and docs/external-data/MASTER_PLAN.md for the historical full integration plan (including future sources).


Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                         User Interfaces                          β”‚
β”‚         CLI   |   REST API   |   Web UI   |   Python SDK         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                     API Gateway (FastAPI)                        β”‚
β”‚           Auth  |  Rate Limiting  |  Validation  |  Audit        β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                      Orchestration Layer                         β”‚
β”‚  Workflow DAG Engine  |  Cron Scheduler  |  Redis Queue Worker   β”‚
β”‚  (parallel exec)      |  (scheduling)    |  (retry, backoff)    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              β”‚               β”‚               β”‚                   β”‚
β”‚  Biological  β”‚   Data        β”‚   AI/LLM      β”‚   Visualization   β”‚
β”‚  Domains     β”‚   Integration β”‚   Gateway     β”‚   Platform        β”‚
β”‚              β”‚               β”‚               β”‚                   β”‚
β”‚  Genome      β”‚   NCBI        β”‚   Gemini     β”‚   Genome Browser  β”‚
β”‚  Sample      β”‚   Ensembl VEP β”‚   Ollama     β”‚   Protein Viewer  β”‚
β”‚  Gene        β”‚   UniProt     β”‚   (local)    β”‚   Network Graphs  β”‚
β”‚  Variant     β”‚   ClinVar     β”‚              β”‚   Scientific      β”‚
β”‚  Transcript  β”‚   gnomAD      β”‚              β”‚   Charts          β”‚
β”‚  Protein     β”‚   PDB/AlphaFold β”‚            β”‚   3D Molecular    β”‚
β”‚              β”‚   ChEMBL/PubChem β”‚           β”‚                   β”‚
β”‚              β”‚   Reactome/KEGG  β”‚           β”‚                   β”‚
β”‚              β”‚   STRING/OpenTargetsβ”‚         β”‚                   β”‚
β”‚              β”‚   EuropePMC/S2     β”‚          β”‚                   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                          Storage Layer                            β”‚
β”‚           PostgreSQL  |  Redis  |  Object Storage                 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

See ARCHITECTURE.md for the full technical breakdown.


Quick Start

# Clone the repository
git clone https://github.com/dsk-dev-ai/GenomeAI.git
cd GenomeAI

# Install all dependencies and start infrastructure
make setup

# Run tests (over 2,150 passing)
make test

# Start the API server
uvicorn genomeai_api.main:app --reload

Requirements: Python 3.12+, Node.js 20+, PostgreSQL 16+, Redis 7+

See docs/development/ for detailed setup guides.


Tech Stack

Layer Technology
API Python 3.12, FastAPI, SQLAlchemy, Pydantic
Database PostgreSQL 16+, Redis 7+
Workflow Engine Python asyncio, DAG execution, Redis queue
Frontend Next.js, React, TypeScript, Tailwind CSS
Visualization D3.js, Three.js, Cytoscape.js, Mol*
AI/LLM Gemini (cloud, default gemini-3.6-flash), Ollama (local)
DevOps Docker, GitHub Actions, Turbo (monorepo)
Testing pytest (2,150+ tests), biome, ruff, pyright

Documentation

Topic Location
Architecture ARCHITECTURE.md
Roadmap ROADMAP.md
API Reference docs/api/
Database Schema docs/database/
Workflow Engine docs/workflows/
External Data & APIs docs/external-data/
AI/ML Guide docs/ai/
Visualization docs/visualization/
Decisions docs/decisions/
Contributing CONTRIBUTING.md

Contributing

We welcome contributions from bioinformaticians, software engineers, data scientists, and researchers.

See CONTRIBUTING.md for guidelines.

# Quick contribution workflow
git checkout -b feat/my-feature
make lint make typecheck make test
git commit -m "feat(domain): add my feature"
git push origin feat/my-feature
# Open a Pull Request


Community

Star History

Star History Chart

⭐ Live chart β€” updates automatically as the repo gains stars. Click the graphic for the interactive view (GitHub restricts public star data, so the embed uses an encrypted star-history.com sealed token).

Sponsor

GenomeAI is built and maintained by Darshan Kachare through NextGenAI Labs.

Sponsorship supports development infrastructure, documentation, and long-term maintenance of this open-source platform.

Sponsor GenomeAI

License

GenomeAI is open source under the Apache 2.0 License.


Built with care for the global research community.
GitHub Β· Discussions Β· Sponsor

About

🧬 Open-source AI platform for genomics & bioinformatics β€” 18 free public science APIs (NCBI, Ensembl, UniProt, ClinVar, gnomAD, PDB, AlphaFold, ChEMBL, PubChem, Reactome, KEGG, STRING, OpenTargets, DGIdb, Europe PMC, Semantic Scholar) with free-tier Gemini AI analysis, workflows, and data visualization. Live demo: FastAPI + Next.js.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages