> For the complete documentation index, see [llms.txt](https://docs.causalchamber.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.causalchamber.ai/remote-lab/quickstart.md).

# Quickstart

{% hint style="info" %}
We assume you already have credentials to access the Remote Lab. You can request access [here](https://forms.causalchamber.ai/lab).
{% endhint %}

{% stepper %}
{% step %}

#### Download the causalchamber package

You can install the [package](https://github.com/juangamella/causal-chamber-package) via pip, i.e.,

```
pip install causalchamber
```

{% endstep %}

{% step %}

#### Set up your credentials

Upon [becoming a subscriber](https://forms.causalchamber.ai/lab), you will receive your credentials through a secure link. Store them in a file with the following content

```ini
[api_keys]
user = <YOUR USERNAME>
password = <YOUR PASSWORD>
```

You can also load the credentials using environment variables (see the next step).

{% hint style="warning" %}
Store your credentials in a safe place. Make sure you don't commit them to a public repository!
{% endhint %}
{% endstep %}

{% step %}

#### You're done!

Start a connection to the remote lab to see your available chambers and submit experiments

{% tabs %}
{% tab title="Credentials file" %}

```python
import causalchamber.lab as lab

rlab = lab.Lab(credentials_file = 'path/to/file')
```

{% endtab %}

{% tab title="Environment variables" %}
If you stored your credentials in environment variables, e.g., `USER` and `KEY`

```python
import os
import causalchamber.lab as lab

rlab = lab.Lab(credentials=(os.getenv('USER'), os.getenv('KEY')))
```

{% endtab %}
{% endtabs %}

<mark style="color:$primary;">Output</mark>

<figure><img src="/files/wGCjYURiE4wINovIaue7" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Next steps

Now you're ready to run experiments on the chambers! You can do so in two ways.

{% columns %}
{% column %}
{% content-ref url="/pages/eQKb9IRV2ljJzz3GaO9e" %}
[Running a real-time experiment](/remote-lab/running-a-real-time-experiment.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
{% content-ref url="/pages/6ismfrBNj2HgguBeI1Yt" %}
[Using the experiment queue](/remote-lab/using-the-experiment-queue.md)
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}
