Quickstart

We assume you already have credentials to access the Remote Lab. You can request access here.

1

Download the causalchamber package

You can install the package via pip, i.e.,

pip install causalchamber

2

Set up your credentials

Upon becoming a subscriber, you will receive your credentials through a secure link. Store them in a file with the following content

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

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

Store your credentials in a safe place. Make sure you don't commit them to a public repository!

3

You're done!

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

Credentials file

import causalchamber.lab as lab

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

Environment variables

If you stored your credentials in environment variables, e.g., USER and KEY

import os
import causalchamber.lab as lab

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

Output

Next steps

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

Running a real-time experiment

Using the experiment queue