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

# Experiments

> Experiments are an instance of a single run in Pluto.

# Creating an Experiment

Within Pluto, an experiment represent a singular instance of a tracked run. To create an experiment, invoke  `pluto.init()` with the experiment `name` and a project `project`.

```python theme={null}
import pluto

pluto.init(name="gpt4o-vision", project="VLLM")
```

You can pass in configurations, e.g hyperparameters the `config` parameter

```python theme={null}
hyperparameters = {
    "lr": 0.001,
    "epochs": 1000,
}

pluto.init(
    dir=".",
    name="gpt4o-vision",
    project="VLLM",
    config=hyperparameters,
)
```

and this will be recorded in the experiment metadata.

<img src="https://mintcdn.com/trainy/xqSYbhN-FFuW4nHK/images/Screenshot2025-12-18at5.30.31PM.png?fit=max&auto=format&n=xqSYbhN-FFuW4nHK&q=85&s=0aa0a16b04fe3d12680d925f071a59b6" alt="Screenshot 2025 12 18 At 5 30 31 PM" width="1752" height="906" data-path="images/Screenshot2025-12-18at5.30.31PM.png" />

<img src="https://mintcdn.com/trainy/xqSYbhN-FFuW4nHK/images/Screenshot2025-12-18at5.30.58PM.png?fit=max&auto=format&n=xqSYbhN-FFuW4nHK&q=85&s=bbe6c979397ce05a114ce510b9c4309c" alt="Screenshot 2025 12 18 At 5 30 58 PM" width="2940" height="1506" data-path="images/Screenshot2025-12-18at5.30.58PM.png" />

## Tags

Tags are plaintext strings and a way for attaching small metadata about your run that will make it easy for you to group/filter runs in the webUI. Multiple tags can be specified for a single run.

To initialize a run with a particular tag, use the `tag` keyword argument which accepts `List[str]`

```
import pluto

pluto.init(
	name="gpt4o-vision", 
	project="VLLM", 
	tags=["production", "v2", "baseline"]
)
```
