# Getting Started

There are two ways to host Burla, in your cloud (self-hosted) or in our cloud (managed).\
Below are guides to get started with both. Don't hesitate to email <jake@burla.dev> if you get stuck!

## Quickstart: Managed

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

1. [Sign up](https://login.burla.dev) using your Google or Microsoft account.
2. Run our 1000-CPU Quickstart:

{% embed url="<https://colab.research.google.com/drive/1msf0EWJA2wdH4QG5wPX2BncSEr5uVufv?usp=sharing>" %}

***

## 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](https://colab.research.google.com/drive/1msf0EWJA2wdH4QG5wPX2BncSEr5uVufv?usp=sharing)

{% hint style="info" %}
Self-Hosted Burla is currently exclusive to Google Cloud.\
Please reach out and tell us if you want to Self-Host, but aren't on GCP! My email is: <jake@burla.dev>
{% endhint %}

#### 1. Ensure `gcloud` is setup and installed:

If you haven't, [install the gcloud CLI](https://cloud.google.com/sdk/docs/install), and [login using application-default credentials](https://cloud.google.com/docs/authentication/set-up-adc-local-dev-environment).

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

<details>

<summary>What permissions does my Google Cloud account need to run <code>burla install</code> ?</summary>

{% hint style="info" %}
If you don't have permissions, run the command anyway, and it will tell you which ones you need!
{% endhint %}

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](/cli-reference.md#prerequisites).

</details>

See the [install docs](/cli-reference.md#burla-install) for more info regarding permissions.

#### 3. Start a machine and run some code!

1. Use the [**Login**](https://login.burla.dev) 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!

```python
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](http://cal.com/jakez/burla), or email **<jake@burla.dev>**. We're always happy to talk.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.burla.dev/get-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.