Quickstart

Get Started

There are two ways to host Burla. In your cloud (Self-Hosted) or in our cloud (Managed).

Quickstart: Managed

Getting started is simple. Our Google Colab notebook contains additional examples and instructions.

  1. Sign up using your Google or Microsoft account.
  2. Run our 1000-CPU Quickstart:
Google Colab colab.research.google.com

Quickstart: Self-Hosted

We recommend you first give Burla a try inside our cloud to make sure it's right for you.
Our quickstart is free and only takes 2 minutes: Quickstart

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 ?

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 to turn the cluster on.
    By default this starts one 4-CPU node. If inactive for >10 minutes this node will shut itself off.
    If you pass grow=True to remote_parallel_map it will start this node by itself.
  3. While booting, run burla login to connect your local computer 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 jake@burla.dev. We're always happy to talk.