Getting Started

Quickstart (managed-instance)

Don't have a managed instance? Click here to get one!

Before continuing, you should have received a response from us that your instance is ready. (usually < 1 hour depending on your timezone)

1. Log in using the email you submitted in the signup form.

2. Hit the ⏻ Start button to boot 1000 CPUs! (should take 1-2 min)

3. While booting, run the following in your local terminal:

   1. pip install Burla

   2. burla login (connects your computer to the cluster)

4. Once booted, run some code!

# Each call to `compute_square` runs in parallel in it's own separate contianer.
# That's why it finishes quickly even though each function call takes ~1 second.

from time import sleep
from burla import remote_parallel_map

def compute_square(x):

    sleep(1)  # <- pretend this is some intense math!

    print(f"Squaring {x} on a separate computer in the cloud!")
    return x * x

squared_numbers = remote_parallel_map(compute_square, list(range(1000)))

1. Celebrate 🎉🎉🎉🎉 You just ran Python code on 1000 CPU's in 1000 separate containers. That's not something many people know how to do!

---

Quickstart (self-hosted)

Self-Hosted Burla is currently exclusive to Google Cloud. We fully intend to support AWS, Azure, and on-prem deployments, but don't yet.

Please reach out anytime if you get stuck! ([email protected])

1. Ensure gcloud is setup and installed:

If you haven't, install the gcloud CLI, and login using application-default credentials.

Ensure gcloud is pointing at the project you wish to install Burla inside:

• To view your current gcloud project run: gcloud config get project

• To change your current gcloud project run: gcloud config set project <NEW-PROJECT-ID>

2. Run the burla install command:

Run pip install burla then run burla install.

What permissions does my Google Cloud account need to run burla install ?

If you don't have permissions, run the command anyway, and it will tell you which ones you need!

To run burla install you'll need permission to run these gcloud commands:

• gcloud services enable ...

• gcloud compute firewall-rules create ...

• gcloud secrets create ...

• gcloud firestore databases create ...

• gcloud run deploy ...

I've listed the exact required permissions for the burla install command in it's CLI doc.

See the install docs for more info regarding permissions.

3. Start a machine and run some code!

1. Use the Login button on this website to get to your new cluster dashboard.

2. Hit the ⏻ Start button in the dashboard to turn the cluster on. By default this starts one 4-CPU node. If inactive for >5 minutes this node will shut itself off.

3. While booting, run burla login to connect your local machine to your cluster.

4. Run the example below!

from burla import remote_parallel_map

def my_function(my_input):
    print("I'm running on remote computer in the cloud!")
    
remote_parallel_map(my_function, [1, 2, 3]) 

---

Questions? Schedule a call with us, or email [email protected]. We're always happy to talk.