Create Custom Protocols
You can define your own custom workflows by uploading a YAML blueprint that describes how models should be linked and what inputs are required.
You can define your own custom workflows by uploading a YAML blueprint that describes how models should be linked and what inputs are required.
Start a New Protocol
From the Protocols page, click Create New Protocol at the top right to open the setup wizard.

Upload or Paste YAML
You can either upload a .yaml file or paste YAML text directly into the editor.
Your YAML definition should include:
- A name for the protocol
- An inputs section defining required parameters
- Any configuration limits or runtime settings
Use Load Example YAML to prefill the editor with a sample schema if you’re not sure where to start.
As you type or upload a file, the Live Parse Preview updates automatically with the parsed name, inputs, and detected tasks.
Click Continue when your YAML looks correct.

Review and Edit the Schema
After the YAML is parsed, the Schema Editor lets you customize your input fields. You can:
- Edit labels, types, and validation options
- Add placeholders, help text, or regex rules
- Reorder or remove inputs
- Switch between Builder and JSON view
This lets you fine-tune the form that users will fill out when running the protocol.

Test with Example Inputs
Next, add example input values to verify that your protocol runs as expected.
You can enter inputs using either:
- Form mode – individual input fields
- JSON mode – a structured data editor
Click Run Test to validate. Once the test completes successfully, your configuration is ready to publish.

Publish and Use Your Protocol
Click Publish Configuration to make your new protocol available in your workspace.
It will appear in the Protocols catalog and can be run just like any built-in workflow.

Tips
- Load Example YAML is a great starting point for structure and syntax.
- Tasks in your YAML (e.g.
antifold_generate,compute_rmsd,igbert_score) represent chained model steps. - You can edit or delete a protocol at any time from the main Protocols dashboard.