GeneVerse: Genetic Trait Mapping & Inheritance Tracker

GeneVerse is an interactive workspace designed to explore, analyze, and simulate genetic inheritance patterns. Built with a focus on accessibility and data visualization, it bridges the gap between complex genetic databases and user-friendly exploration.

---

🧬 Project Overview

Genetic data can be overwhelming and difficult to interpret without the right tools. GeneVerse provides a centralized platform to browse curated genes and traits, visualize distributions through an analytics dashboard, and run predictive simulations for inheritance.

Key Features

• Comprehensive Genetic Database: Browse a curated list of genes and traits, including inheritance patterns, symbols, and association counts.

• Interactive Analytics Dashboard: Real-time visualization of genetic data using Chart.js, covering:

• Inheritance pattern distributions.

• Most studied genes.

• Trait categories and ethnicity-based metrics.

• Trait Simulator: Predict the likelihood of trait expression based on selected inheritance patterns (Dominant/Recessive) and population data.

• Polygenic Builder: A specialized tool to analyze how multiple genes interact to influence a single trait, featuring a CSV Export for research tracking.

• Personal Dashboard: Manage family member profiles and generate text-based genetic inheritance summaries.

• AI Genetics Assistant: An integrated chatbot powered by the Hugging Face Inference API to answer natural language questions about genetics.

---

🛠️ Tech Stack

• Frontend: HTML5, CSS3, Vanilla JavaScript (ES6+)
• Data Visualization: Chart.js
• Backend: Flask (Python)
• Database: SQLite (Relational database with 3NF normalization)
• AI Integration: Hugging Face Inference API

---

🚀 Getting Started

Prerequisites

• Python 3.8+
• pip (Python package manager)

Installation

1. Clone the repository:

git clone https://github.com/Deshnaa2007/GeneVerse.git
cd GeneVerse

2. Create and activate a virtual environment:

python -m venv .venv
# Windows:
.\.venv\Scripts\Activate
# Mac/Linux:
source .venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Set up environment variables (Optional - for Chatbot):

# Set your Hugging Face Token to enable the AI Chatbot
$env:HF_TOKEN = "your_token_here" 

5. Run the application:

python app.py

The app will be available at http://localhost:5000.

---

📂 Project Structure

GeneVerse/
├── app.py              # Flask backend & API endpoints
├── gen.sql             # Database schema and seed data
├── database.db         # SQLite database (auto-generated)
├── script.js           # Frontend logic & API handling
├── style.css           # Global application styling
├── templates/          # HTML Pages
│   ├── index.html      # Landing Page
│   ├── analytics.html  # Data Visualizations
│   ├── simulator.html  # Trait & Polygenic Tools
│   ├── dashboard.html  # Family & Inheritance Logs
│   └── chatbot.html    # AI Assistant Interface
└── README.md           # Documentation

---

📊 API Overview

The backend provides several RESTful endpoints for data retrieval:

• GET /api/genes: Returns list of all genes.
• GET /api/traits: Returns list of all traits and inheritance patterns.
• POST /api/simulator: Calculates trait probabilities.
• GET /api/charts/inheritance-patterns: Data for inheritance distribution charts.
• POST /api/chatbot: Submits queries to the AI assistant.

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🤝 Contributing

Contributions are welcome! If you have suggestions for new features or data improvements, feel free to open an issue or submit a pull request.

Author: Deshna24