Sovereign 8s.is mirror of standardgalactic/AGENTEX
  • Jupyter Notebook 56%
  • Python 44%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-10 19:31:52 -04:00
AGENTEX reactions Add files via upload 2026-07-10 19:25:10 -04:00
Nucleic_acid_purifications Add files via upload 2026-07-10 19:25:26 -04:00
README.md Add files via upload 2026-07-10 19:31:52 -04:00

AGENTEX Automated Translation Prototyping

Python 3.10 Opentrons API

This repository contains automated laboratory protocols designed for the Opentrons OT-2 liquid handling robot, as described in Automated Prototyping of Genetic Codes by Felix Radford, Nayan Sapers, Hana Burgess, Lucy Ort, Bogdan Budnik, and George Church. Protocols are provided for automated purification of DNA templates, setup of specified enzymatic reactions and cell-free translation reactions, and tRNA purifications. This provides an end-to-end workflow from dsDNA template and tRNA pool production to translation prototyping. The workflows are divided into Nucleic Acid Purifications (DNA/RNA) and AGENTEX Reactions (Protein purifications and reaction mixing).

Table of Contents

Repository Structure

├── AGENTEX reactions/
│   ├── Protein/
│   │   └── protein purifications.ipynb    # Automated protein purification workflow
│   └── Reactions/
│       ├── mixing_csv_generator.py        # Generates Opentrons transfer commands from plates
│       ├── reactions.xlsx                 # Template for reaction contents
│       └── sample_plate1/2.xlsx           # Templates for source plate layouts
└── Nucleic_acid_purifications/
    ├── DNA/
    │   └── DNA purification.ipynb         # Automated DNA purification workflow
    └── RNA/
        ├── Step 1/Purification.py         # Bead addition, resuspension, and incubation
        ├── Step 2/mixing.py               # Transfer and mixing logic based on CSVs
        └── Step 3/Purification.py         # Final elution and sample recovery

Requirements

Software Environment

  • Python: Version 3.10
  • Opentrons App & Server: Ensure your OT-2 robot is running Opentrons robot stack version 7.2.0.

Hardware Prerequisites

  • Opentrons OT-2 Robot
  • Magnetic Module (GEN2) (Required for DNA/RNA/Protein purifications)
  • P300 8-Channel Pipette (GEN2)
  • P20 Single-Channel Pipette (GEN2)
  • Two Temperature Modules with 96-well aluminum temperature blocks

Dependencies

Install the necessary third-party packages to execute the CSV generators and lint the Opentrons scripts locally:

Installation

Clone the repository and install the Python dependencies:

git clone [https://github.com/FelixRadford/AGENTEX.git](https://github.com/FelixRadford/AGENTEX.git)
cd AGENTEX
pip install opentrons numpy pandas openpyxl

Usage Guide

1. RNA Purifications (Multi-Step Pipeline)

Located in Nucleic_acid_purifications/RNA/. These scripts must be loaded into the Opentrons app sequentially:

  1. Step 1: First tRNA purification from IVT reactions.
  2. Step 2: Performs PNK digestion, inherited from general mixing script.
  3. Step 3: Second tRNA purification after PNK digestion.

2. Automated Translation reactions

Before running the Opentrons translation reactions, prepare your reaction mapping:

  1. Navigate to AGENTEX reactions/Reactions/.
  2. Fill out the sample_plate1.xlsx, sample_plate2.xlsx, and reactions.xlsx templates.
  3. Run the generator script to compile these into an executable CSV for the robot:
    python mixing_csv_generator.py
    
  4. Then run general mixing script to set up translation reactions:
    python mixing.py
    

3. Jupyter Notebook Workflows (DNA & Protein purifications)

For interactive automation of DNA and Protein purifications, Jupyter notebooks are provided. Run Jupyter notebook in the Opentrons App. Navigate to Nucleic_acid_purifications/DNA/DNA purification.ipynb or AGENTEX reactions/Protein/protein purifications.ipynb and execute the cells.

⚠️ Notes and Best Practices

  • RNase Decontamination: Always spray down the deck, modules, and used reservoirs with anti-RNase spray before running the RNA steps.
  • Tiprack Placement: The scripts will prompt you for the required number of tipracks dynamically based on the transfer counts (calculated dynamically via the math module). Ensure you check standard output for deck mapping instructions.
  • Excess Volumes: When filling reagent reservoirs (like Wash or Elution buffers), always add slight excess as too little may result in air aspiration.