# Import librairies from pathlib import Path from typing import Optional from uuid import uuid4 import hashlib import json import gradio as gr import gemmi from gradio_molecule3d import Molecule3D from modal_app import app, chai1_inference, download_inference_dependencies, here from numpy import load from typing import List theme = gr.themes.Default( text_size="md", radius_size="lg", ) # Helper functions def select_best_model( run_id: str, number_of_scores: int=5, scores_to_print: List[str]=None, results_dir: str="results/score", prefix: str="-scores.model_idx_", ): """ Selects the best model based on the aggregate score among several simulation results. Args: run_id (str): Unique identifier for the inference run. number_of_scores (int, optional): Number of models to evaluate (number of score files to read). Default is 5. scores_to_print (List[str], optional): List of score names to display for each model (e.g., ["aggregate_score", "ptm", "iptm"]). Default is ["aggregate_score", "ptm", "iptm"]. results_dir (str, optional): Directory where the result files are located. Default is "results/score". prefix (str, optional): Prefix used in the score file names. Default is "-scores.model_idx_". Returns: Tuple[int, float]: - best_model (int): Index of the best model (the one with the highest aggregate score and without inter-chain clashes). - max_aggregate_score (float): Value of the highest aggregate score. """ print(f"🧬 Start reading scores for each inference...") if scores_to_print is None: scores_to_print = ["aggregate_score", "ptm", "iptm"] max_aggregate_score = 0 best_model = None for model_index in range(number_of_scores): print(f" 🧬 Reading scores for model {model_index}...") data = load(f"{results_dir}/{run_id}{prefix}{model_index}.npz") if data["has_inter_chain_clashes"][0] == False: for item in scores_to_print: print(f"{item}: {data[item][0]}") else: print(f" 🧬 Model {model_index} has inter-chain clashes, skipping scores.") continue if data["aggregate_score"][0] > max_aggregate_score: max_aggregate_score = data["aggregate_score"][0] best_model = int(model_index) print( f"🧬 Best model is {best_model} with an aggregate score of {max_aggregate_score}." ) return best_model, max_aggregate_score # Definition of the tools for the MCP server # Function to return a fasta file def create_fasta_file(file_content: str, name: Optional[str] = None, seq_name: Optional[str] = None) -> str: """Create a FASTA file from a biomolecule sequence string with a unique name. Args: file_content (str): The content of the FASTA file required with optional line breaks name (str, optional): FASTA file name ending with .fasta ideally. If not provided, a unique ID will be generated seq_name (str, optional): The name/identifier for the sequence. Defaults to "protein" Returns: str: Name of the created FASTA file """ # If the file_content is empty, raise an error if not file_content.strip(): print("Fasta file content cannot be empty so the example fasta file will be used") file_content = ">protein|name=example-protein\nAGSHSMRYFSTSVSRPGRGEPRFIAVGYVDDTQFVRFD" # Remove any trailing/leading whitespace but preserve line breaks lines = file_content.strip().split('\n') # Check if the first line is a FASTA header if not lines[0].startswith('>'): # If no header provided, add one if seq_name is None: seq_name = "protein" file_content = f">{seq_name}\n{file_content}" # Create FASTA content (preserving line breaks) fasta_content = file_content # Generate a unique file name unique_id = hashlib.sha256(uuid4().bytes).hexdigest()[:8] if name: file_name = name else: file_name = f"chai1_{unique_id}.fasta" file_path = here / "inputs/fasta" / file_name # Write the FASTA file with open(file_path, "w") as f: f.write(fasta_content) # Function to create a JSON file def create_json_config( num_diffn_timesteps: int, num_trunk_recycles: int, seed: int, options: list, name: Optional[str] = None ) -> str: """Create a JSON configuration file from the Gradio interface inputs. Args: num_diffn_timesteps (int): Number of diffusion timesteps from slider num_trunk_recycles (int): Number of trunk recycles from slider seed (int): Random seed from slider options (list): List of selected options from checkbox group name (str, optional): JSON config file name ending with .json ideally. If not provided, a unique ID will be generated Returns: str: Name of the created JSON file """ # Convert checkbox options to boolean flags use_esm_embeddings = "ESM_embeddings" in options use_msa_server = "MSA_server" in options # Create config dictionary config = { "num_trunk_recycles": num_trunk_recycles, "num_diffn_timesteps": num_diffn_timesteps, "seed": seed, "use_esm_embeddings": use_esm_embeddings, "use_msa_server": use_msa_server } # Generate file name based on provided name or unique ID unique_id = hashlib.sha256(uuid4().bytes).hexdigest()[:8] if name: file_name = name else: file_name = f"chai1_{unique_id}.json" file_path = here / "inputs/config" / file_name # Write the JSON file with open(file_path, "w") as f: json.dump(config, f, indent=4) # Function to compute Chai1 inference def compute_Chai1( fasta_file_name: Optional[str] = "", inference_config_file_name: Optional[str] = "", ): """Compute a Chai1 simulation. Args: fasta_file_name (str, optional): FASTA file name to use for the Chai1 simulation. If not provided, uses the default input file. inference_config_file_name (str, optional): JSON configuration file name for inference. If not provided, uses the default quick inference configuration. Returns: pd.DataFrame: DataFrame containing model scores and CIF file paths """ import pandas as pd with app.run(): force_redownload = False print("🧬 checking inference dependencies") download_inference_dependencies.remote(force=force_redownload) # Define fasta file if not fasta_file_name: fasta_file_name = here / "inputs/fasta" / "chai1_default_input.fasta" print(f"🧬 running Chai inference on {fasta_file_name}") fasta_file_name = here / "inputs/fasta" / fasta_file_name print(fasta_file_name) fasta_content = Path(fasta_file_name).read_text() # Define inference config file if not inference_config_file_name: inference_config_file_name = here / "inputs/config" / "chai1_quick_inference.json" inference_config_file_name = here / "inputs/config" / inference_config_file_name print(f"🧬 loading Chai inference config from {inference_config_file_name}") inference_config = json.loads(Path(inference_config_file_name).read_text()) # Generate a unique run ID run_id = hashlib.sha256(uuid4().bytes).hexdigest()[:8] # short id print(f"🧬 running inference with {run_id=}") results = chai1_inference.remote(fasta_content, inference_config, run_id) # Define output directory output_dir = Path("./results") output_dir.mkdir(parents=True, exist_ok=True) print(f"🧬 saving results to disk locally in {output_dir}") # Create lists to store data for DataFrame model_data = [] for ii, (scores, cif) in enumerate(results): score_file = Path(output_dir, "score") / f"{run_id}-scores.model_idx_{ii}.npz" cif_file = Path(output_dir, "molecules") / f"{run_id}-preds.model_idx_{ii}.cif" score_file.write_bytes(scores) cif_file.write_text(cif) # Load score data data = load(str(score_file)) if not data["has_inter_chain_clashes"][0]: model_data.append({ "Model Index": ii, "Aggregate Score": float(data["aggregate_score"][0]), "PTM": float(data["ptm"][0]), "IPTM": float(data["iptm"][0]), "CIF File": str(cif_file).split("/")[-1], # Get just the file name }) # Create DataFrame from collected data results_df = pd.DataFrame(model_data).sort_values("Aggregate Score", ascending=False) return results_df # Function to plot the 3D protein structure def plot_protein(result_df) -> str: """Plot the 3D structure of a biomolecule using the DataFrame from compute_Chai1. Args: result_df (pd.DataFrame): DataFrame containing model information and scores Returns: str: Path to the generated PDB file of the best model. """ if result_df.empty: return "" # Return empty string instead of None for type safety # Get the CIF file path of the model with highest aggregate score (already sorted) best_cif = str(Path("results/molecules") / result_df.iloc[0]["CIF File"]) # Generate PDB file name pdb_file = best_cif.replace('.cif', '.pdb') # Convert CIF to PDB if it doesn't exist if not Path(pdb_file).exists(): st = gemmi.read_structure(best_cif) st.write_minimal_pdb(pdb_file) return pdb_file # Function to plot a CIF file def show_cif_file(cif_file): """Plot a 3D structure from a CIF file with the Molecule3D library. Args: cif_file: A biomolecule structure file in CIF format. This can be a file uploaded by the user. If None, the function will return None. Returns: str or None: PDB file name if successful, None if no file was provided or if conversion failed. """ if not cif_file: return None cif_path = Path(cif_file.name) st = gemmi.read_structure(str(cif_path)) pdb_file = cif_path.with_suffix('.pdb') st.write_minimal_pdb(str(pdb_file)) # Convert PosixPath to string return str(pdb_file) # Create the Gradio interface reps = [{"model": 0,"style": "cartoon","color": "hydrophobicity"}] with gr.Blocks(theme=theme) as demo: gr.Markdown( """ # Protein Folding Simulation Interface This interface provides the tools to fold FASTA chains based on Chai-1 model. Also, this is a MCP server to provide all the tools to automate the process of folding biomolecules with LLMs. """) with gr.Tab("Introduction 🔭"): gr.Image("images/logo1.png", show_label=False, width=600, show_download_button=False, show_fullscreen_button=False, show_share_button=False) gr.Markdown( """ # Stakes The industry is undergoing a profound transformation due to the development of Large Language Models (LLMs) and the recent advancements that enable them to access external tools. For years, companies have leveraged simulation tools to accelerate and reduce the costs of product development. One of the primary challenges in the coming years will be to create agents capable of setting up, running, and processing simulations to further expedite innovation. Engineers will focus on analysis rather than simulation setup, allowing them to concentrate on the most critical aspects of their work. # Objective This project represents a first step towards developing AI agents that can perform simulations using existing engineering softwares. Key domains of application include: - **CFD** (Computational Fluid Dynamics) simulations - **Biology** (Protein Folding, Molecular Dynamics, etc.) - **Neural network applications** While this project focuses on biomolecules folding, the principles employed can be extended to other domains. Specifically, it uses [Chai-1](https://www.chaidiscovery.com/blog/introducing-chai-1), a multi-modal foundation model for molecular structure prediction that achieves state-of-the-art performance across various benchmarks. Chai-1 enables unified prediction of proteins, small molecules, DNA, RNA, glycosylations, and more. Industrial computations frequently require substantial resources (large number of CPUs and GPUs) that are performed on High-Performance Computing (HPC) clusters. To this end, [Modal Labs](https://modal.com/), a serverless platform that offers a straightforward method to run any application with the latest CPU and GPU hardware, will be used. MCP servers are an efficient solution to connect LLMs to real world engineering applications by providing access to a set of tools. The purpose of this project is to enable users to run biomolecule folding simulations using the Chai-1 model through any LLM chat or with a Gradio interface. # Benefits 1. **Efficiency**: The MCP server's connected to high-performance computing capabilities ensure that simulations are run quickly and efficiently. 2. **Ease of Use**: Only provide necessary parameters to the user to simplify the process of setting up and running complex simulations. 3. **Integration**: The seamless integration between the LLM's chat interface and the MCP server allows for a streamlined workflow, from simulation setup to results analysis. The following video illustrates a practical use of the MCP server to run a biomolecule folding simulation using the Chai-1 model. In this scenario, Copilot is used in Agent mode with Claude 3.5 Sonnet to leverage the tools provided by the MCP server. """ ) gr.HTML( """ """, label="MCP demonstration video" ) gr.Markdown( """ # MCP tools 1. `create_fasta_file`: Create a FASTA file from a biomolecule sequence string with a unique name. 2. `create_json_config`: Create a JSON configuration file from the Gradio interface inputs. 3. `compute_Chai1`: Compute a Chai-1 simulation on Modal labs server. Return a DataFrame with protein scores. 4. `plot_protein`: Plot the 3D structure of a biomolecule using the DataFrame from `compute_Chai1` (Use for Gradio interface). 5. `show_cif_file`: Plot a 3D structure from a CIF file with the Molecule3D library (Use for the Gradio interface). """) with open("introduction_page.md", "r") as f: intro_md = f.read() gr.Markdown(intro_md) gr.Markdown( """ # Result example The following image shows an example of a protein folding simulation using the Chai-1 model. The simulation was run with the default configuration and the image is 3D view from the Gradio interface. """) gr.Image("images/protein.png", show_label=True, width=400, label="Protein Folding example", show_download_button=False, show_fullscreen_button=False, show_share_button=False) gr.Markdown( """ # What's next? 1. Expose additional tools to post-process the results of the simulations (ex: Plot images of the molecule structure from a file). The current post-processing tools are suited for the Gradio interface. 2. Continue the pipeline by adding software like [OpenMM](https://openmm.org/) or [Gromacs](https://www.gromacs.org/) for molecular dynamics simulations. 3. Perform full simulation plans including loops over parameters fully automated by the LLM. # Contact For any issues or questions, please contact the developer or refer to the documentation. """) with gr.Tab("Configuration 📦"): gr.Markdown( """ ## Fasta file and configuration generator (optional) """) with gr.Row(): with gr.Column(scale=1): slider_nb = gr.Slider(1, 500, value=300, label="Number of diffusion time steps", info="Choose the number of diffusion time steps for the simulation", step=1, interactive=True, elem_id="num_iterations") slider_trunk = gr.Slider(1, 5, value=3, label="Number of trunk recycles", info="Choose the number of iterations for the simulation", step=1, interactive=True, elem_id="trunk_number") slider_seed = gr.Slider(1, 100, value=42, label="Seed", info="Choose the seed", step=1, interactive=True, elem_id="seed") check_options = gr.CheckboxGroup(["ESM_embeddings", "MSA_server"], value=["ESM_embeddings",], label="Additional options", info="Options to use ESM embeddings and MSA server", elem_id="options") config_name = gr.Textbox(placeholder="Enter a name for the json file (optional)", label="JSON file name") button_json = gr.Button("Create Config file") button_json.click(fn=create_json_config, inputs=[slider_nb, slider_trunk, slider_seed, check_options, config_name], outputs=[]) with gr.Column(scale=1): fasta_input = gr.Textbox(placeholder="Fasta format sequences", label="Fasta content", lines=10) fasta_name = gr.Textbox(placeholder="Enter the name of the fasta file name (optional)", label="Fasta file name") fasta_button = gr.Button("Create Fasta file") fasta_button.click(fn=create_fasta_file, inputs=[fasta_input, fasta_name], outputs=[]) gr.Markdown( """ ## Example Fasta File ``` >protein|name=example-protein AGSHSMRYFSTSVSRPGRGEPRFIAVGYVDDTQFVRFD ``` """) with gr.Tab("Run folding simulation 🚀"): with gr.Row(): with gr.Column(scale=1): inp2 = gr.FileExplorer(root_dir=here / "inputs/config", value="chai1_default_inference.json", label="Configuration file", file_count='single') with gr.Column(scale=1): inp1 = gr.FileExplorer(root_dir=here / "inputs/fasta", value="chai1_default_input.fasta", label="Input Fasta file", file_count='single') btn_refresh = gr.Button("Refresh available files") # Only workaround I found to update the file explorer def update_file_explorer(): """Don't need to be used by LLMs, but useful for the interface to update the file explorer""" return gr.FileExplorer(root_dir=here), gr.FileExplorer(root_dir=here) def update_file_explorer_2(): """Don't need to be used by LLMs, but useful for the interface to update the file explorer""" return gr.FileExplorer(root_dir=here / "inputs/fasta"), gr.FileExplorer(root_dir=here / "inputs/config") btn_refresh.click(update_file_explorer, outputs=[inp1,inp2]).then(update_file_explorer_2, outputs=[inp1, inp2]) #out = Molecule3D(label="Plot the 3D Molecule", reps=reps) out = gr.DataFrame( headers=["Model Index", "Aggregate Score", "PTM", "IPTM", "CIF File"], datatype=["number", "number", "number", "number", "str"], label="Inference Results sorted by Aggregate Score", visible=True, ) out2 = Molecule3D(label="Plot the 3D Molecule", reps=reps) btn = gr.Button("Run Simulation") btn.click(fn=compute_Chai1, inputs=[inp1 , inp2], outputs=[out]).then( fn=plot_protein, inputs=out, outputs=out2 ) with gr.Tab("Plot CIF file 💻"): gr.Markdown( """ ## Plot a 3D structure from a CIF file """) cif_input = gr.File(label="Input CIF file", file_count='single') cif_output = Molecule3D(label="Plot the 3D Molecule", reps=reps) cif_input.change(fn=show_cif_file, inputs=cif_input, outputs=cif_output) # Launch both the Gradio web interface and the MCP server if __name__ == "__main__": demo.launch(mcp_server=True)