> For the complete documentation index, see [llms.txt](https://docs.biodock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biodock.ai/start/path-2-train-a-fully-automated-ai-model/run-your-ai-model.md).

# Run your AI model

*What you'll get: your model run on all your images, with results grouped by folder so you can compare conditions. About 1 minute of work.*

A model is **Active** as soon as training finishes, and ready to run. It runs on any number of images on Biodock's cloud computers.

## 1. Start the run from your model

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-ceefe5f5869f0623c7881e433d610ef63934f63c%2Fdocs-start-run-model.gif?alt=media" alt="On a model version, Use for analysis is clicked, the New analysis page opens and Automated batch is clicked, with the model already picked; Add files opens Choose images, the Control and Treatment folders are ticked and Confirm selection is clicked; the run is named in the Job manifest and the cursor rests on Submit"><figcaption><p><strong>Use for analysis</strong> → <strong>Automated batch</strong> → <strong>Add files</strong> → tick your folders → <strong>Confirm selection</strong> → name the run → <strong>Submit</strong>.</p></figcaption></figure>

1. Open your project, click the model version on the **All models** tab, and click **Use for analysis**. The **New analysis** page opens. Under **Analysis type**, click **Automated batch**: your model is already picked under **Pipeline**.

   You can also start from **Analysis** → **Start new analysis**: under **Analysis type**, choose **Automated batch**, then under **Pipeline** pick your project from **Your models**. If it has more than one active version, choose the version on its card.
2. Under **Input files**, click **Add files**. In **Choose images**, tick the images or folders to analyse (a folder brings every image inside it), and click **Confirm selection**.
3. Under **Parameters**, check **Channel mapping**: which channel of your images is which. If your images are the same kind the model learned on, there is nothing to change. All the images in one run need the same number of channels.
4. Optionally, pick a **Results folder** to file the analysis in.
5. In the **Job manifest** on the right, type a name under **Job name**. The manifest lists anything still missing in red, and shows what the run will cost (see [Credits, storage and limits](https://docs.biodock.ai/account/credits-storage-and-limits.md)).
6. Click **Submit**.

Every option on this page is explained in [Running an analysis](https://docs.biodock.ai/analysis-and-results/running-an-analysis.md).

### Folders become groups

Each folder you pick becomes an image group in the results, so you can compare groups straight away, for example Control against Treatment. Before you run an analysis, put each condition in its own folder. The page shows the groups under **Results will be arranged into the following groups**.

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-e883c9e93557b91029d4b1ac3afb104d95291020%2Fdocs-start-results-groups.png?alt=media" alt="The Input files section after picking two folders, with the panel Results will be arranged into the following groups listing Control and Treatment"><figcaption><p>Two folders picked: the results will have a <strong>Control</strong> group and a <strong>Treatment</strong> group.</p></figcaption></figure>

### Who will see the results

In a workspace, a new analysis is private: above **Submit** you see **Only you will see the results**. If you pick a **Results folder** that others can see, the line changes to **Others will see this analysis**. See [Sharing and visibility](https://docs.biodock.ai/workspaces/workspaces/sharing-and-visibility.md).

A model belongs to the place it was trained in. A model trained in a workspace runs only in that workspace, and one trained in your personal account runs only there.

## 2. Follow the run

Your run appears at the top of the **Analysis** list with a progress bar. Click **Watch live** to follow it on the **Job details** tab. It goes from **Queued** to **Processing** to **Succeeded**. It is safe to close the tab and come back later.

Bigger and more images take longer; a run usually takes between 6 and 30 minutes.

## 3. Read your results

When the run has finished, click it in the **Analysis** list. It opens on the **Dashboard** tab, with statistics, plots and your images with their outlines. Download your numbers from **Export data**. See [Results dashboard overview](https://docs.biodock.ai/analysis-and-results/results-dashboard-overview.md).

## Keep your list tidy

When a newer version is better, take the old one off the list so nobody runs it by mistake. On the old version, click **Deactivate** and confirm. Nothing is deleted, and old analyses keep their results. **Activate model** brings it back. Only project owners can do this.

## Next steps

* [Labeling shortcuts](https://docs.biodock.ai/projects-and-models/labeling-shortcuts.md): every keyboard shortcut in the labeler.
* [Configuring your model](https://docs.biodock.ai/projects-and-models/configuring-your-model.md): predict more or fewer objects, change what is measured, and set up hierarchies.
* [Evaluating performance](https://docs.biodock.ai/projects-and-models/evaluating-performance.md): what the numbers in **Training statistics** mean.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.biodock.ai/start/path-2-train-a-fully-automated-ai-model/run-your-ai-model.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
