> 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).

# Get started

Welcome to the Remote Lab!

If you don't want to [build a Chamber](https://github.com/juangamella/causal-chamber/tree/main/hardware), you can use our Python API to [run interactive experiments](https://docs.causalchamber.ai/remote-lab/running-a-real-time-experiment.md) and [collect datasets](https://docs.causalchamber.ai/remote-lab/using-the-experiment-queue.md) from the Chambers in our Zurich facility. We call this the Remote Lab.

{% hint style="info" %}
Use the [sign-up form](https://forms.causalchamber.ai/signup) to get your API credentials. See [Quickstart](#quickstart) below to set them up.
{% endhint %}

#### **How much does it cost?**

Under usage-based pricing, cost is based on runtime (see [How credits work](https://docs.causalchamber.ai/remote-lab/how-credits-work.md)). There is no minimum price, and we provide 1000 credits on [sign-up](https://forms.causalchamber.ai/signup) so you can try out the system for free. As in a compute cluster, you run your experiments on hardware shared with other researchers.

If you require dedicated Chambers or want to run an extensive data-collection campaign, you can also rent Chambers in our facility; this provides exclusive access (no waiting) and a flat rate for Chamber runtime. [Contact us](mailto:contact@causalchamber.ai) for more details.

#### **Can you help me design experiments?**

Yes! Write us an email at <science@causalchamber.ai>, and we'll be happy to help. We also provide technical support via email to help you use our platform (see [Error handling & support](https://docs.causalchamber.ai/remote-lab/error-handling-and-support.md)).

## Quickstart

{% hint style="info" %}
You will need API credentials to access the Remote Lab. To get your credentials, please use the [sign-up form](https://forms.causalchamber.ai/signup).
{% 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

After completing the [signup](https://forms.causalchamber.ai/signup), you will receive an email with a secure link to your credentials. 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
from causalchamber import lab

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

{% endtab %}

{% tab title="Environment variables" %}
If you stored your credentials in the environment variables `CAUSALCHAMBER_USER` and `CAUSALCHAMBER_PASSWORD`, you can just run

```python
from causalchamber import lab

rlab = lab.login()
```

{% endtab %}
{% endtabs %}

<mark style="color:$primary;">As output, login prints a dashboard with an overview of your experiments and the available Chambers and their status.</mark>

<figure><img src="https://3492874807-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUqYDL9yvLTNUYW7H1Q6t%2Fuploads%2Fgit-blob-9efb9d4cde51b52379072221e7db81de74947f02%2Falice_dashboard_fresh.jpg?alt=media" 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/ZmekWOzidZ47F6qTpCDK" %}
[Running an interactive experiment](https://docs.causalchamber.ai/remote-lab/running-a-real-time-experiment.md)
{% endcontent-ref %}
{% endcolumn %}

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