Skip to content

faith-ogun/RegulonForge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿงฌ RegulonForge

Simulating the Dark Genome with Gemini 3 Pro

Google DeepMind Hackathon Built with Gemini License: CC BY-SA 4.0


RegulonForge Demo

98% of the human genome doesn't code for proteins โ€” yet these "dark" regions control gene expression and harbor disease-driving mutations. RegulonForge is a multimodal AI simulator that helps researchers and students explore non-coding regulatory logic.


๐ŸŽฏ The Problem

While coding variants benefit from well-established interpretation frameworks, non-coding mutations remain a critical bottleneck in cancer genomics and precision medicine. Researchers rely on fragmented annotations, static databases, and indirect statistical signals โ€” leaving most regulatory logic unresolved.

๐Ÿ’ก The Solution

RegulonForge demonstrates how multimodal reasoning can help close this gap. Built with Gemini 3 Pro, it provides an interactive environment for exploring the regulatory consequences of non-coding variants.


โœจ Features

๐Ÿ”ฌ Multimodal Analysis

Upload genome browser screenshots (UCSC, IGV) alongside DNA sequences. Gemini identifies chromatin tracks, predicts motifs, and correlates visual and sequence context โ€” true vision-language reasoning for genomics.

๐Ÿงช Perturbation Sandbox

Compare wild-type and mutant sequences side-by-side. Visualize how motifs, TF binding logic, and regulatory network topology shift upon mutation.

โœ๏ธ Sketch-to-Sequence

Draw regulatory elements freehand on a canvas. Gemini interprets your sketch, infers the underlying grammar, and generates synthetic DNA prototypes.

๐Ÿ•ฐ๏ธ Evolution Viewer

Explore inferred evolutionary constraints acting on regulatory motifs without requiring phylogenetic alignments.

๐Ÿ“š Teaching Mode

Interactive quizzes transform mechanistic explanations into accessible learning experiences.

๐Ÿ“„ Literature Grounding

All analyses include citations to peer-reviewed literature (ENCODE, PCAWG, etc.) for scientific credibility.


๐Ÿš€ Quick Start

Try it Online

๐Ÿ‘‰ Launch RegulonForge (Google AI Studio)

Run Locally

# Clone the repository
git clone https://github.com/faith-ogun/regulonforge.git
cd regulonforge

# Install dependencies
npm install

Prerequisites: Node.js

Set the GEMINI_API_KEY in .env.local to your Gemini API key
Run the app: npm run dev

๐Ÿ› ๏ธ Tech Stack

Layer Technology
AI Model Gemini 3 Pro (multimodal)
Framework React + TypeScript
Styling Tailwind CSS
Animations Framer Motion
3D Graphics Three.js / React Three Fiber
Build Tool Vite
PDF Export jsPDF

๐Ÿ“ Project Structure

regulonforge/
โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ Home.tsx              # Educational landing page
โ”‚   โ”œโ”€โ”€ Analysis.tsx          # Main analysis interface
โ”‚   โ”œโ”€โ”€ InputSection.tsx      # Sequence & image input
โ”‚   โ”œโ”€โ”€ ResultsGrid.tsx       # Analysis results display
โ”‚   โ”œโ”€โ”€ Sandbox.tsx           # WT vs Mutant perturbation
โ”‚   โ”œโ”€โ”€ EvolutionViewer.tsx   # Conservation analysis
โ”‚   โ”œโ”€โ”€ SketchMode.tsx        # Draw regulatory elements
โ”‚   โ”œโ”€โ”€ Header.tsx            # Navigation
โ”‚   โ””โ”€โ”€ Footer.tsx            # Credits & links
โ”œโ”€โ”€ services/
โ”‚   โ””โ”€โ”€ geminiService.ts      # Gemini API integration
โ”œโ”€โ”€ types.ts                  # TypeScript interfaces
โ”œโ”€โ”€ App.tsx                   # Main app component
โ””โ”€โ”€ index.tsx                 # Entry point

๐ŸŽฎ Usage

1. Analysis Mode

1. Paste a DNA sequence (40-2000 bp)
2. Optionally add genomic coordinates
3. Optionally specify variants (e.g., "Pos 42 G>T")
4. Upload a genome browser screenshot for multimodal analysis
5. Choose "Mechanistic" or "Teaching" mode
6. Click "Run Analysis"

2. Sketch Mode

1. Select a drawing tool (Peak, Motif, Enhancer, etc.)
2. Draw your regulatory element concept
3. Click "Interpret Sketch"
4. Review the inferred grammar and prototype sequence
5. Generate remixes and send to Sandbox

Keyboard Shortcuts

Shortcut Action
Ctrl + Enter Run Analysis
Ctrl + E Load Example
Ctrl + L Clear Inputs

๐Ÿ”ฌ Example: TERT Promoter

The TERT promoter is one of the most well-characterized non-coding cancer drivers. Try it:

Sequence: CAGGGGGCCGGGGCCGCGGGGGGTCCGGGCGGGGGGGGGCGGGGCCGGGGGCGGGGGCCGGG
Coordinates: Chr5:1,295,228 (hg19) - TERT Promoter
Variant: Pos 42 G>T

Upload a UCSC Genome Browser screenshot of the region to see multimodal analysis in action.


๐Ÿ“Š How It Works

graph LR
    A[DNA Sequence] --> D[Gemini 3 Pro]
    B[Browser Image] --> D
    C[Variants] --> D
    D --> E[Element Classification]
    D --> F[Motif Mapping]
    D --> G[Variant Impact]
    D --> H[TF Network]
    D --> I[Literature Citations]
Loading

๐Ÿ† Hackathon Submission

This project was built for the Google DeepMind "Vibe Code with Gemini 3 Pro" Hackathon (December 2025).


๐Ÿงฌ Why Non-Coding Regions Matter

Non-coding variants are increasingly implicated in:

  • Cancer predisposition โ€” TERT promoter mutations drive multiple cancer types
  • Drug response โ€” Regulatory variants affect pharmacogenomics
  • Disease progression โ€” Enhancer hijacking alters oncogene expression

As precision medicine advances, the ability to interpret regulatory mutations will become essential for diagnosis and therapeutic targeting.


๐Ÿ‘ฉโ€๐Ÿ”ฌ About the Author

Faith Ogundimu

PhD Researcher at RCSI (Royal College of Surgeons in Ireland), studying non-coding somatic driver mutations in breast cancer. Government of Ireland Postgraduate Scholar.


๐Ÿ“„ License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.


๐Ÿ™ Acknowledgments

  • Google DeepMind for hosting the hackathon and providing Gemini 3 Pro
  • ENCODE Project for regulatory element annotations
  • UCSC Genome Browser for visualization tools
  • My PhD supervisors at RCSI for guidance on non-coding genomics

RegulonForge โ€” Making the dark genome readable.

Try it now โ†’

About

Multimodal regulatory genomics simulator for exploring non-coding mutations, TF networks, and chromatin logic with Gemini 3 Pro.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors