AFusion is a user-friendly graphical interface designed to simplify the process of generating input JSON files and running AlphaFold 3 predictions. It streamlines the setup and execution of AlphaFold 3, making it accessible to users who prefer a GUI over command-line interactions.
Demo site (generate input JSON files ONLY)
- ✨ Intuitive Interface: Easily configure job settings, sequences, and execution parameters through a clean and modern GUI.
- 📋 Entity Management: Add multiple entities (Protein, RNA, DNA, Ligand) with support for modifications, MSA options, and templates.
- ⚙️ Dynamic JSON Generation: Automatically generates the required JSON input file for AlphaFold 3 based on user inputs.
- 🚀 Integrated Execution: Run AlphaFold 3 directly from the GUI with customizable Docker execution settings.
- 🖥️ Visual Feedback: Provides command output within the interface for monitoring and debugging.
Before using AFusion, ensure that you have the following:
-
🐳 Docker Installed: Docker is required to run AlphaFold 3. Install Docker from the official website.
-
🧬 AlphaFold 3 Installed: AFusion requires AlphaFold 3 to be installed and set up on your system. Follow the installation instructions provided in the AlphaFold 3 GitHub Repository to deploy AlphaFold 3.
-
🐍 Python 3.10 or Higher: AFusion is built with Python and requires Python 3.10 or higher.
-
Install AFusion
Run the following command in your terminal to install AFusion:
pip install afusion
-
Run AFusion
After installation, you can start AFusion by running:
afusion
This will launch the AFusion graphical user interface (GUI) in your default web browser.
Please Note:
-
🧬 AlphaFold 3 Installation: Ensure you have correctly installed AlphaFold 3, including model parameters and required databases, following the AlphaFold 3 Installation Guide.
-
⚙️ Docker Configuration: After installing Docker, make sure it is running properly and that your user has permission to execute Docker commands.
-
📦 Streamlit is Included in Dependencies: AFusion's installation will automatically install all required dependencies, including Streamlit. There's no need to install it separately.
If you encounter any issues during installation or usage, please refer to the relevant official documentation or contact us for support.
-
🚀 Start the Streamlit App
From the project directory, run:
afusion
-
🌐 Access the Application
- The application will launch, and Streamlit will provide a local URL (e.g.,
http://localhost:8501). - Open the provided URL in your web browser to access AFusion.
- The application will launch, and Streamlit will provide a local URL (e.g.,
Find more about input in here.
- 👋 Logo and Introduction: You'll see the AFusion logo and a brief description.
- 📑 Navigation Sidebar: Use the sidebar on the left to navigate to different sections of the app.
- 🏷️ Job Name: Enter a descriptive name for your job.
- 🔢 Model Seeds: Provide integer seeds separated by commas (e.g.,
1,2,3).
- 🔬 Number of Entities: Select how many entities you want to add (Proteins, RNA, DNA, Ligand).
- 📋 Entity Details: For each entity:
- ⚛️ Entity Type: Select the type (Protein, RNA, DNA, Ligand).
- 🆔 Entity ID: Provide an identifier for the entity.
- 🧬 Sequence Input: Enter the sequence information.
- ✏️ Modifications: Optionally add modifications with their types and positions.
- 📂 MSA Options: Choose MSA generation options and provide MSA data if applicable.
- 📜 Templates: Optionally add template data with mmCIF content and indices.
- 🔗 Add Bonds: Check the box to add bonded atom pairs.
- ⚛️ Define Bonds: For each bond, provide details for the first and second atoms, including entity IDs, residue IDs, and atom names.
- 📜 User CCD Input: Paste or enter custom CCD data in mmCIF format.
- 📄 Review JSON Content: The application generates the JSON input file based on your entries. You can review it here.
-
🗂️ Paths Configuration:
- 📁 AF Input Path: Specify the path to the AlphaFold input directory (e.g.,
/home/user/af_input). - 📂 AF Output Path: Specify the path to the output directory (e.g.,
/home/user/af_output). - 📂 Model Parameters Directory: Provide the path to the model parameters directory.
- 📂 Databases Directory: Provide the path to the databases directory.
- 📁 AF Input Path: Specify the path to the AlphaFold input directory (e.g.,
-
⚙️ Execution Options:
- 🏗️ Run Data Pipeline: Choose whether to run the data pipeline (CPU-intensive).
- 💻 Run Inference: Choose whether to run inference (requires GPU).
- 💾 Save JSON File: Click the "Save JSON File" button to save the generated JSON to the specified input path.
▶️ Run AlphaFold 3 Now: Click the "Run AlphaFold 3 Now▶️ " button to execute the AlphaFold 3 prediction using the Docker command.- 🔧 Docker Command: The exact Docker command used is displayed for your reference.
- 📊 Command Output: Execution output is displayed within the app for monitoring.
- ♻️ Refactor Code and Publish to PyPI: Refactor the project code for improved modularity and maintainability, and publish the latest version to PyPI for easy installation.
- 🔗 Integrate Alphafold-analysis: Incorporate Alphafold-analysis into the project for detailed analysis of AlphaFold prediction results.
- ⚛️ Preset Common Small Molecules & Metal Ions: Add a dedicated section for quick access to commonly used small molecules and metal ions.
- 🧬 Add Common Covalent Modifications: Include predefined options for common covalent modifications with user customization capabilities.
- 🛠️ New Tool for Chemical Small Molecules: Develop a new tool to handle and model chemical small molecules, supporting seamless integration into the prediction pipeline.
This project is licensed under the GPL3 License - see the LICENSE file for details.
- AlphaFold 3: This GUI is designed to work with AlphaFold 3 by DeepMind.
- Streamlit: AFusion is built using Streamlit, an open-source app framework for machine learning and data science teams.
- Contributors: Waiting for more!
If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request.
Happy Folding! 🧬