- Jupyter Notebook 56%
- Python 44%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| AGENTEX reactions | ||
| Nucleic_acid_purifications | ||
| README.md | ||
AGENTEX Automated Translation Prototyping
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:
- Step 1: First tRNA purification from IVT reactions.
- Step 2: Performs PNK digestion, inherited from general mixing script.
- Step 3: Second tRNA purification after PNK digestion.
2. Automated Translation reactions
Before running the Opentrons translation reactions, prepare your reaction mapping:
- Navigate to
AGENTEX reactions/Reactions/. - Fill out the
sample_plate1.xlsx,sample_plate2.xlsx, andreactions.xlsxtemplates. - Run the generator script to compile these into an executable CSV for the robot:
python mixing_csv_generator.py - 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
mathmodule). 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.