Skip to content

This is the frontend repository for GeneScope, a website aligned with Illumina that allows users to enhance their knowledge of biotechnology through interactive games and educational tools.

License

Notifications You must be signed in to change notification settings

Open-Coding-Society/genescope

 
 

Repository files navigation

Biotechnology Education Platform (Illumina-Aligned)

An interactive website designed for students and educators to explore biotechnology, genetics, and DNA sequencing. Built as a resource to support AP Computer Science Principles, Data Structures, and Biology classes using real-world tools and datasets modeled after Illumina’s genomic technologies.

For educaters and leaners

This project can be used to:

  • Demonstrate biotechnology concepts interactively
  • Integrate biology and computer science curricula
  • Enable students to explore DNA sequences, mutation types, and gene function hands-on
  • Foster inquiry-based learning through visual tools and interactive simulations

Educational Features

  • Hands-on gene mutation simulation using real DNA sequences.
  • Select from Sandbox or Fix-the-Gene game modes.
  • Interactive tutorial guides walk users through genetic concepts.
  • Connects biology and computer science in a tangible way.
  • Designed for classroom integration or independent learning.

Live Site + GitHub


Integrated Datasets

This project uses real and simulated data from the following sources:


Technologies Used

  • Backend: Python, Flask
  • Frontend: Jinja2, Tailwind CSS, HTML, JavaScript
  • Database: SQLite3 (with preloaded .db files)
  • APIs: Ensembl, OpenTDB, NIH/NCBI (via JSON)
  • Deployment: Docker, docker-compose, AWS, NGINX

Acknowledgments

  • Developed for the Open Coding Society

  • Entered into the pilot city Illumina Interactive Biotech Education Game project

  • Dataset and science design inspired by Illumina, NIH, NCBI, and Kaggle

  • JWT login and user auth by Aiden Wu, CSP Contributor


License

MIT License © 2025 Nora Ahadian, Sonika Denuva, Katherine Chen, Zoe He, Avika Prasad, Gabriela Connelly


Project Setup

1. clone and install

mkdir -p ~/biotech-edu && cd ~/biotech-edu
git clone https://github.com/nighthawkcoders/flask_2025.git
cd flask_2025
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

### 2. run the app
flask run

### 3. a .env file in your backend
#### containing these user defaults
ADMIN_USER= "toby"
ADMIN_PASSWORD= "123Toby!"
DEFAULT_USER= "hop"
DEFAULT_PASSWORD= "123Hop!"

### 4. Generate your own gemini api key labeled:
API_KEY

### 5. Initialize the database
./scripts/db_init.py

About

This is the frontend repository for GeneScope, a website aligned with Illumina that allows users to enhance their knowledge of biotechnology through interactive games and educational tools.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages

  • SCSS 51.4%
  • HTML 18.7%
  • Python 10.8%
  • Jupyter Notebook 7.1%
  • JavaScript 6.4%
  • Shell 4.3%
  • Other 1.3%