A personal genome exploration tool that combines your 23andMe genetic data with Claude AI to help you understand your DNA. Browse your SNPs, get AI-powered interpretations, and build a growing knowledge base about your genetic variants.
The dashboard gives you an at-a-glance overview of your genome exploration progress:
- Stats: See your total SNPs, annotations from SNPedia, Claude-generated annotations, and total knowledge entries
- Most Interesting Genes: Automatically curated list of your most significant genetic variants based on magnitude, research interest, and activity
- Needs Attention: High-impact genes that haven't been annotated yet, with one-click annotation
The "Needs Attention" section highlights important variants that could use Claude's annotation. Click any card to start the annotation process automatically.
Export your genome data and annotations in multiple formats:
- Annotated SNPs (JSON/CSV): Export only SNPs with research data
- Favorites Only: Export just your starred SNPs
- All SNPs: Complete genome export
The Query tab lets you ask natural language questions about your DNA. Claude searches your genome, finds relevant SNPs, looks up your genotypes, and provides personalized interpretations.
Type any question or use the suggested prompts:
- "What are my most significant genetic variants?"
- "Do I have any risk variants for common diseases?"
- "What genes affect my metabolism?"
- "Tell me about my ancestry-related SNPs"
When you submit a query, Claude analyzes your genome in real-time:
You can switch tabs while waiting - your results will be ready when you return.
Claude returns detailed, personalized analysis based on your actual genotypes:
Results include specific interpretations for your variants, with confidence levels and scientific context.
Each response covers multiple aspects - from direct trait predictions to ancestry indicators and interesting bonus findings.
Below the summary, you'll see cards for each relevant gene mentioned in the response:
Each card shows:
- RS number and gene name
- Your genotype
- Magnitude score (importance)
- Categories and tags
- Clickable citations to scientific sources
Click any gene card to open the sidebar with more details:
The sidebar shows:
- Gene summary
- Your genotype interpretation
- Categories
- Quick actions: View Full Page, Ask Claude, View on SNPedia
Click "View Full Page" to see the complete gene profile:
The full page includes:
- Complete summary with inline citations
- Your genotype highlighted
- Chromosome location
- All associated categories and tags
- Reanalyze with AI: Choose quality level (Quick/Standard/Premium) for deeper analysis
- Source badge showing which AI model tier was used for the annotation
See explanations for all possible genotypes, with yours highlighted:
Each genotype variant includes:
- Population frequency
- Associated traits or risks
- Scientific citations
Every piece of research about a gene is saved to your personal knowledge base:
This includes:
- SNPedia raw data
- Claude annotations and improvements
- Your query conversations
- Gene interpretations
The History tab keeps track of all your genome queries:
Each entry shows:
- Your original question
- When you asked it
- Number of SNPs mentioned in the response
- Ability to re-run or hide queries
Click any query to expand and see the full response, or click the refresh icon to run it again with updated data.
The Browse tab lets you explore all your SNPs with powerful filtering:
- Text search: Search by RS number, gene name, or keywords
- Tag search: Search and filter by tags with the dedicated search box
- Multi-tag selection: Click multiple tags to filter by combinations
- Genotype labels: Filter by risk, normal, protective, carrier, or neutral variants
- Chromosome: Jump to specific chromosomes
- Clear all filters: Reset all active filters with one click
The tag panel shows common tags (20+ SNPs) by default. Use the search box to find specific tags, or check "Include rare" to see more niche categories.
Select multiple tags to find SNPs at the intersection of categories.
The sidebar shows your variants organized by AI classification:
- Risk: Variants associated with increased risk or adverse effects
- Normal: Common, typical variants (population baseline)
- Protective: Variants associated with reduced risk or beneficial effects
- Carrier: You carry one copy of a recessive variant
- Neutral: Variants with no clear positive or negative impact
The Data Log tab shows all system activity and lets you monitor the annotation process:
See a live feed of recently annotated genes with:
- Gene title and summary
- Annotation timestamp
- Quick links to view each gene
Watch Claude's reasoning in real-time as it processes annotation requests.
The complete data log shows every system event:
- SNPedia data fetches
- Gene discovery matches
- Claude conversations
- Annotation improvements
Filter by source type and search content to find specific entries.
Star important SNPs to save them to your Favorites tab:
Your favorites are displayed as detailed cards showing:
- Gene name and RS number
- Your genotype
- Summary and categories
- Magnitude and risk indicators
Click the star on any gene card throughout the app to add or remove from favorites.
- Python 3.9+
- Node.js 18+
- A 23andMe raw data file (download from 23andMe > Settings > 23andMe Data > Download Raw Data)
- An Anthropic API key (get one at https://console.anthropic.com/)
-
Clone the repository
git clone https://github.com/v64/genome-browser.git cd genome-browser -
Add your genome data
Place your 23andMe raw data file in the project root directory:
cp ~/Downloads/genome_Your_Name_v5_Full_20240101.txt .
-
Configure your API key
cp .env.example .env
Edit
.envand add your Anthropic API key:ANTHROPIC_API_KEY=sk-ant-api03-your-actual-key-here -
Start the application
./start.sh
-
Open your browser
Navigate to http://localhost:5173 and start exploring your genome!
The app includes an intelligent background worker that continuously expands your knowledge:
- Starts from genes in your existing annotations
- Queries Claude for related genes
- Checks if you have SNPs for discovered genes
- Auto-annotates any new SNPs found
- Adds newly discovered genes to the exploration queue
On startup, the app automatically fetches annotations for your most important SNPs based on magnitude scores.
| Key | Action |
|---|---|
| 1 | Dashboard tab |
| 2 | Query tab |
| 3 | History tab |
| 4 | Browse tab |
| 5 | Data Log tab |
| 6 | Favorites tab |
| Esc | Close sidebar/modal |
- Your data stays local: All genome data is stored in a local SQLite database on your machine
- No data uploaded: Your genetic information is never sent anywhere except to Claude for AI analysis
- API key required: You control your own Anthropic API key and usage
- Git-ignored: Genome files, database, and
.envare excluded from version control
This app uses the Claude API which has per-token costs:
- Queries: ~$0.01-0.05 per query (Claude Sonnet)
- Gene discovery: ~$0.001-0.01 per discovery (Claude Haiku)
- Annotations (depends on quality level):
- Quick (Haiku): ~$0.001-0.005 per SNP - fast bulk processing
- Standard (Sonnet): ~$0.01-0.03 per SNP - balanced detail
- Premium (Opus): ~$0.05-0.15 per SNP - comprehensive analysis
Responses are cached in the knowledge base to avoid repeat API calls.
| Problem | Solution |
|---|---|
| "ANTHROPIC_API_KEY not set" | Copy .env.example to .env and add your API key |
| Genome file not found | Ensure your 23andMe file is in the project root and matches genome*.txt |
| Port already in use | Run pkill -f uvicorn && pkill -f vite or use ./reset.sh |
| Database issues | Run ./reset.sh to clear the database and start fresh |
MIT
This tool is for educational and informational purposes only. It is not intended to provide medical advice. Always consult with healthcare professionals for medical decisions. Genetic associations are complex and many findings are preliminary or have small effect sizes.