Skip to main content
PlatyGeno Icon

Unsupervised Biological Significance Mapping via
Evo 2 & Sparse Autoencoders

PyPI version License DOI

PlatyGeno identifies genomic landmarks directly from raw sequence data. By leveraging the Evo 2 foundation model, it isolates biologically significant DNA structures (promoters, coding sequences, precise motifs) based purely on AI confidence—without requiring labels, databases, or BLAST.

🧪 Technical Validation (IBD-MDB)

PlatyGeno v1.0.4 has been validated using the clinical IBD Metagenomic Database dataset. For complete statistical data and methodology, see the PlatyGeno Technical Audit and the PlatyGeno Technical Supplemental.

Summary of Results:

  • Novel Genomic Landmarks: Identified Feature 7393, a 101bp sequence with no prior database matches and a high-confidence structural model (AlphaFold2 best prediction; pLDDT ≈ 80).

    Feature 7393 Structure
    Representative best structural prediction (AlphaFold2) of the novel Feature 7393 discovered autonomously by PlatyGeno.

  • Statistical Correlation: Verified a Pearson correlation of r = 0.84 (p < 10-50) between sequence length and match significance.

  • Resolution Gain: Consensus assembly provided a 1038 increase in E-value confidence over isolated 60bp fragments.

  • Taxonomic Profile: 72% of high-activation discoveries successfully cross-validated with target gut microbiota.


🏗️ Technical Foundation

PlatyGeno operates as a Reference-Free Microscope, detecting the "Signal" of life directly from genomic grammar.

🔭 The Discovery Core

  • AI-Native Interpretation: We use a Sparse Autoencoder (SAE) to translate the complex DNA "grammar" understood by Evo 2 into 32,768 human-interpretable biological concepts (e.g., promoters, viral motifs).
  • Peak Pinpointing (Layer 26): The engine intercepts signals at Layer 26 to identify the exact coordinate where a biological feature fires with the highest intensity.
  • Dual-Mode Discovery: Preserves both narrow Precision Snippets (separatedly high-interest DNA clips) and Consensus Assemblies (overlapping sequences from multiple reads of the same feature pieced together ).

👉 For a full hierarchical deep-dive into the methodology and validation trail, see Technical Architecture.


⚙️ Setup & Installation

⚙️ Installation & Quick Start

PlatyGeno requires a CUDA-enabled GPU (RTX 3090, 4090, A100, or H100).

# 1. Install the core package
pip install platygeno

# 2. Install high-performance GPU kernels (Mandatory for speed)
pip install ninja # for faster installation of flash-attn
pip install flash-attn --no-build-isolation

# 3. Verify & Run Discovery (on the validation sample)
platygeno --input data/sample.fastq --limit 5000 --threshold 5.0

🚀 Quick Start for GitHub Clones

# 1. Clone & Enter
git clone https://github.com/khoatran1995/PlatyGeno.git
cd PlatyGeno

# 2. Install High-Performance Kernels & editable package
pip install flash-attn --no-build-isolation
pip install -e .

# 3. Trigger Discovery
platygeno --input data/sample.fastq --limit 5000

📚 Documentation

API Reference: Details on Evo 2 integrations and technical Python parameters.


🚀 Usage & API Reference

🚀 Advanced Python Discovery

Researchers can integrate the engine into custom discovery pipelines:

import platygeno

# Advanced Discovery: Tuning parameters for clinical audits
results = platygeno.discover_genes(
    input_path="data/sample.fastq",
    scan_end=5000,
    min_activation=8.0,      # High-confidence threshold
    batch_size=32            # GPU-optimized batching
)

# View discovered biological features
print(results[['feature_id', 'feature_name', 'activation', 'sequence']])

platygeno.discover_genes() Reference

Parameter Type Default Description
input_path str Req Path to sequence file.
min_activation float 5.0 Minimum signal strength.
rel_freq_max float 1.0 Rarity cap (1.0 = All significance).
scan_end int None Last read index (None for end of file).
top_n int -1 Max features to return (-1 for ALL).

⚡ Performance

Mode Engine Implementation Runtime (20k Reads) Discovery Speed
v1.0.4 Batched Mean-Pooling ~4.8 Minutes 🚀 100% (High Speed)

📜 References

⚠️ Technical Limitations

  • Pre-training Bias: Sensitivity depends on the Evo 2 pre-training corpus.
  • SAE Bottleneck: Discrete compression may miss extremely subtle biological nuances.
  • Validation Requirement: High significance is a "Beacon," not final functional proof.

📜 References

@software{PlatyGeno2026,
  author = {Khoa Tu Tran},
  title = {PlatyGeno: Unsupervised Significance Mapping via Evo 2},
  url = {https://github.com/khoatran1995/PlatyGeno},
  doi = {10.5281/zenodo.19581708},
  year = {2026}
}

Thanks to Together AI (Evo 2) and Goodfire AI (SAE interpretability) and the IBD Metagenomic Database (IBD-MDB). Please cite the relevant references when using PlatyGeno.

Metadata

Release files for platygeno 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for platygeno 1.0.4
File Size Uploaded
platygeno-1.0.4.tar.gz 48.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for platygeno 1.0.4
File Interpreter ABI Platform
platygeno-1.0.4-py3-none-any.whl Python 3 none any Details

Total release size: 93.5 kB

Release files / platygeno-1.0.4.tar.gz

Download URL platygeno-1.0.4.tar.gz
Size 48.2 kB
Tags Source
SHA-256 checksum
How to use checksums
60c87f4072fef365f70853c134ea99d8146a14fbaca10b98c2c037f07e29f529
BLAKE2b-256 checksum
How to use checksums
3f90f80e37f2c5128d0c3edbdd771865fad8fbeabec4a5172756ab4a42549d53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / platygeno-1.0.4-py3-none-any.whl

Download URL platygeno-1.0.4-py3-none-any.whl
Size 45.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ab9d7c1552165b5ba113fd39c651f20b16cefa43102095d21dc9da171cb37546
BLAKE2b-256 checksum
How to use checksums
457d675447a5617f02fb2c221c01dcdde1eb106850c56682c287ca03dc0354aa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release history Release notifications | RSS feed

This release

1.0.4 This release

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page