> ## Documentation Index
> Fetch the complete documentation index at: https://proto.evodesign.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# re:Agent Hackathon

> Installation paths for re:Agent participants, 15 to 16 August 2026

# re:Agent Hackathon

<Frame>
  <img noZoom src="https://mintcdn.com/bio-pro/pc_HSW1fdmPNdVwr/assets/images/reagent-hackathon.jpg?fit=max&auto=format&n=pc_HSW1fdmPNdVwr&q=85&s=e7376a3b369c7af0ca0405e3029878c3" alt="re:Agent: end to end agentic science, 15 to 16 August 2026" width="360" data-path="assets/images/reagent-hackathon.jpg" />
</Frame>

Proto consists of two separate packages. They build on each other, but each one is useful on its
own, so install whichever suits what you are building. Both can run their models on Modal compute.

<Info>
  This page is a temporary guide for re:Agent participants. The reference documentation it links to
  is the permanent home for all of this material.
</Info>

## Two Paths

<CardGroup cols={2}>
  <Card title="Path A: Tools" icon="wrench" href="/docs/tools/introduction">
    Ready-to-run implementations of a wide range of computational biology models and tools. Each
    tool defines typed input, config, and output objects, which makes tools straightforward to run
    and to chain together.
  </Card>

  <Card title="Path B: Language" icon="code" href="/docs/language/introduction">
    An optimization layer built on top of proto-tools. Create design loops from structured
    primitives: segments, constructs, generators, constraints, and optimizers.
  </Card>
</CardGroup>

### Path A: proto-tools

Install the package:

```bash bash icon="terminal" theme={null}
pip install git+https://github.com/evo-design/proto-tools.git
```

That is the whole installation. Tool environments are built on first use, so there is nothing
further to set up before running a tool.

<Card title="Tools: Installation" icon="download" href="/docs/tools/installation">
  Storage configuration, gated model access, and remote compute
</Card>

### Path B: proto-language

Install proto-language as editable so you can add your own generators and constraints:

```bash bash icon="terminal" theme={null}
git clone https://github.com/evo-design/proto-language.git
cd proto-language
pip install -e .
```

This installs proto-tools as a dependency, so Path B gives you the full tool catalog as well.

<Card title="Language: Installation" icon="download" href="/docs/language/installation">
  Prerequisites, GPU requirements, and the non-editable install
</Card>

## Set Up Modal Compute

Both paths can run models and tools on Modal, which is worth doing if you do not have your own GPU
access.

<Note>
  re:Agent participants receive Modal credits for the event. The redemption link is provided at the
  hackathon.
</Note>

<Steps>
  <Step title="Authenticate">
    ```bash bash icon="terminal" theme={null}
    pip install modal
    modal setup
    ```

    This opens your browser to link the account.
  </Step>

  <Step title="Deploy and run tools">
    You are now ready to deploy and run tools. The full walkthrough covers creating an environment,
    deploying a tool, and running it.

    <Card title="Modal Integration" icon="cloud" href="/docs/tools/modal-integration">
      Deploying and running tools on Modal
    </Card>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Tools: Quickstart" icon="rocket" href="/docs/tools/guides/quickstart">
    Run your first tool
  </Card>

  <Card title="Language: Quickstart" icon="play" href="/docs/language/quickstart">
    Design your first sequence
  </Card>

  <Card title="Language: Concepts" icon="book-open" href="/docs/language/concepts/overview">
    Segments, constructs, generators, constraints, and optimizers
  </Card>

  <Card title="Example Programs" icon="flask-conical" href="/docs/language/guides/examples/dna-optimization">
    Complete programs to start from
  </Card>
</CardGroup>