Skip to content
SquaredPianoPublic

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Proteus Logo

Proteus

An IDE for the code of life — from prompt to editable DNA workspace in real time.

Next.js React FastAPI Redis

Demo Video · Report Bug


🎬 Demo

ProteusCompressedv2.mp4

From a sentence to generated DNA, live confidence, editable regions, and predicted structure.


✨ Overview

Proteus is the better, rebuilt evolution of Helix, our original AI-native genomic design IDE.

Helix proved that a natural-language objective could become generated DNA, scored candidates, predicted structures, and an editable workspace. Proteus takes that same vision further with a real inline sequence editor, region-level regeneration, stronger scientific tooling, live research evidence, durable experiment history, and honest visibility into which engines are running.

"Describe the biology. Generate the sequence. Edit the code of life."

Features

Feature Description
🧬 Evo 2 Generation Generate DNA with NVIDIA-hosted Evo 2 40B, a local engine, or deterministic mock mode.
✍️ Real Sequence Editor Select, overwrite, reverse-complement, mutate, and re-score bases directly.
🔁 Region Regeneration Rewrite only a selected region, splice it back in, and refold the result.
🧱 3D Fold Studio Explore ESMFold predictions with confidence coloring and side-by-side comparison.
🤖 Helio Agent Explain regions, use scientific tools, and connect model output to real evidence.
📚 Live Research Context Retrieve NCBI, PubMed, ClinVar, and semantically ranked literature.
🧪 Scientific Tooling JASPAR motifs, CRISPR scoring, codon optimization, primer design, Tm, and RNA structure.
🕒 Versioned Experiments Compare edits, restore earlier states, and optionally persist complete sessions.

🚀 Setup & Deployment

The only requirement is Docker Desktop.

Quick Start

  1. Clone and configure

    git clone https://github.com/SquaredPiano/evo.git
    cd evo
    cp .env.example .env
    # Add available API keys; mock mode works without them.
  2. Run

    docker compose up --build
  3. Open


🛠️ Architecture

Proteus keeps Helix's streaming, event-driven core and extends it with richer editing, scientific computation, evidence, and persistence:

Prompt -> Intent Parse -> Retrieval (NCBI / PubMed / ClinVar)
      -> Evo 2 Generation -> Scoring -> ESMFold -> Explanation
      -> Editable Workspace -> Region Regeneration
  • Frontend: Next.js 16, React 19, Zustand, Framer Motion, Three.js.
  • Backend: FastAPI, Pydantic, Redis-backed sessions and event flow.
  • AI stack: Evo 2, ESMFold, OpenRouter, and a LangGraph agent.
  • Science: Biopython, DNA Chisel, Primer3, ViennaRNA, and JASPAR.
  • Persistence: Redis for live sessions with optional MongoDB snapshots and history.
  • Transport: REST for control plus WebSocket streaming.

Proteus runs without API keys in deterministic mock mode and upgrades each subsystem independently when live engines are configured. The interface always reports the backend's actual state.


⚠️ Research Use Note

Proteus is a research and design platform, not a clinical decision system. Treat its outputs as hypotheses requiring domain review and experimental validation.


🤝 Contributing

Contributions are welcome. Please fork the repository and submit a pull request.


Proteus · Helix, evolved

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages