rlipas/dnagent: AI-Powered DNA Research Assistant - Codeberg.org
This website requires JavaScript.
rlipas/dnagent
Watch
Star
Fork
You've already forked dnagent
Code
Issues
Pull requests
Activity
AI-Powered DNA Research Assistant
13 commits
1 branch
0 tags
178 KiB
TypeScript
85.4%
JavaScript
13.9%
Dockerfile
0.4%
Shell
0.2%
Makefile
0.1%
main
Find a file
HTTPS
Download ZIP<br>Download TAR.GZ<br>Download BUNDLE
Open with VS Code
Open with VSCodium
Open with Intellij IDEA
Ricardo Lipas Augusto
f4e6d509a3
docs(readme): restructure sections for better flow and add npm publish config
...<br>Reorder README sections with Preview kept near top, Quick Start and<br>API Keys moved up, and Project Goals moved toward the end.<br>Deduplicate prerequisites and build steps.
Fix package.json for npm publishing: correct repository URL to<br>Codeberg, add files/engines/homepage/bugs fields, add prepublishOnly<br>script.
2026-05-20 09:08:21 -03:00
src
chore: rename to DNAgent and prepare v0.1.0 public release
2026-05-19 11:33:13 -03:00
test
feat: initial agenet DNA research assistant
2026-05-15 14:02:36 -03:00
.dockerignore
feat(docker): add Dockerfile and .dockerignore with Docker Hub instructions
2026-05-19 13:36:56 -03:00
.gitignore
feat: initial agenet DNA research assistant
2026-05-15 14:02:36 -03:00
AGENTS.md
chore: rename to DNAgent and prepare v0.1.0 public release
2026-05-19 11:33:13 -03:00
CHANGELOG.md
docs: update URLs to pi.dev and fix copyright year/project name
2026-05-19 15:15:00 -03:00
Dockerfile
feat(docker): add Dockerfile and .dockerignore with Docker Hub instructions
2026-05-19 13:36:56 -03:00
LICENSE
docs: fix README typos and LICENSE copyright attribution
2026-05-19 18:03:47 -03:00
Makefile
feat: initial agenet DNA research assistant
2026-05-15 14:02:36 -03:00
package-lock.json
chore: rename to DNAgent and prepare v0.1.0 public release
2026-05-19 11:33:13 -03:00
package.json
docs(readme): restructure sections for better flow and add npm publish config
2026-05-20 09:08:21 -03:00
README.md
docs(readme): restructure sections for better flow and add npm publish config
2026-05-20 09:08:21 -03:00
test.sh
feat: initial agenet DNA research assistant
2026-05-15 14:02:36 -03:00
tsconfig.json
feat: initial agenet DNA research assistant
2026-05-15 14:02:36 -03:00
README.md
🧬 DNAgent — AI-Powered DNA Research Assistant
DNAgent is a CLI-based AI agent that loads raw DNA data files, searches and cross-references genetic variants against gene databases and public annotation APIs (ClinVar, gnomAD), and helps researchers and curious individuals explore possible implications of a broad range of genes.
⚠️ For research and educational purposes only. DNAgent does not provide medical diagnoses or clinical recommendations. Always consult a qualified healthcare provider for medical decisions.
👀 Preview
Click to expand — full sample output<br>$ dnagent --file ../dna/AncestryDNA.txt --model openrouter/deepseek/deepseek-v4-flash
📄 DNA File Loaded<br>──────────────────────────────────────────────────<br>Path: ../dna/AncestryDNA.txt<br>Records: 675.356<br>Chr: 26<br>Het: 202.834<br>Hom: 472.522
══════════════════════════════════════════════
🧬 DNAgent — DNA Research Assistant<br>Model: openrouter/deepseek/deepseek-v4-flash | Thinking: medium<br>──────────────────────────────────────────────
Welcome to DNAgent — DNA Research Assistant
To get started, you can:<br>• Search a variant: "Search for rs4680"<br>• Look up a gene: "Tell me about the MTHFR gene"<br>• Analyze variants: "Analyze variants in the BRCA1 gene"<br>• Annotate: "What do we know about rs4680?"<br>• Get help: ?help
Data file: ../dna/AncestryDNA.txt — ready to explore!<br>──────────────────────────────────────────────<br>🧬
## 👋 Welcome to DNAgent!
Great, your AncestryDNA file has been loaded successfully with **675,356 records**. Let me give you a quick overview of what stands out:
### 📊 Key Observations About Your Data
| Metric | Value | Notes |<br>|--------|-------|-------|<br>| **Total SNPs** | 675,356 | Solid coverage across the genome |<br>| **Heterozygous** | 202,834 | ~30% — variants where you have two different alleles |<br>| **Homozygous Alt** | 472,522 | ~70% — variants where you have two copies of the non-reference allele |<br>| **Insertions** | 6,389 | These are interesting — AncestryDNA flags these as structural variants |<br>| **Deletions** | 0 | None detected in this dataset |
**Chromosome coverage** is good across all autosomes (1–22), plus **25,218 records on the X chromosome** (Chr 23), a handful on Chr 24 (Y — 3 records), Chr 25 (Mitochondrial — 36 records), and **263 records on Chr 26** (likely the XY pseudoautosomal region / PAR).
### 🔍 What You Can Explore Here
Here are some things you might want to check out:
1. **🧬 Common health & trait genes**<br>- **MTHFR** — folate metabolism (a very popular one to check)<br>- **CYP1A2** — caffeine metabolism ("slow" vs "fast" metabolizer)<br>- **ACTN3** — muscle performance/power athlete trait<br>-...