README.md

---
title: Antibody Database Dashboard
emoji: 🔎
colorFrom: blue
colorTo: green
sdk: docker
app_file: app.py
pinned: false
license: mit
short_description: Interactive antibody database - filter, analyze, and export 
---

# 🧬 Antibody Database Dashboard

An interactive web dashboard for exploring antibody sequence data using Gradio and Plotly. This dashboard allows users to filter antibody sequences by various criteria and visualize the data through interactive charts.

## Features

- **Interactive Filtering**: Filter sequences by VH/VL germline, B-cell type, disease, and sequence length
- **Data Visualization**: 
  - VH and VL germline distribution charts
  - Length distribution histograms
  - Year-wise sequence distribution
- **Data Export**: Download filtered sequences as FASTA files
- **Real-time Statistics**: View sequence counts and statistics

## 🚀 Usage

1. **Select Filters**:
   - Choose VH and VL germlines from dropdowns
   - Select B-cell type and disease
   - Adjust sequence length sliders

2. **Apply Filters**:
   - Click "Apply Filters" to update the dashboard
   - View filtered data in the table
   - Explore visualizations

3. **Export Data**:
   - Download filtered sequences as FASTA files
   - View sequence counts and statistics

## 📋 Requirements

- Python 3.11+
- Required packages (see `requirements.txt`):
  - `gradio>=4.0.0`
  - `pandas>=1.5.0`
  - `plotly>=5.0.0`
  - `huggingface_hub>=0.16.0`
  - `numpy>=1.21.0`

## 🗂️ Project Structure

```
dashboard_learning/
├── dashboard.py               # Main dashboard application
├── utils.py                   # Utility functions for data processing
├── requirements.txt           # Python dependencies
└── README.md                  # This file
```