> For the complete documentation index, see [llms.txt](https://docs.burla.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.burla.dev/get-started.md).

# Getting Started

We recommend you first give Burla a try inside our cloud to make sure it's right for you.\
To try this [schedule a call with us](https://cal.com/jakez/burla?user=jakez\&duration=30) and we'll send you a managed trial instance afterward.

{% 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 are missing. Email <jake@burla.dev> if you need any help!
{% 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 ...`

The **exact required permissions** for `burla install` are listed in the [CLI documentation](/cli-reference.md#prerequisites).

</details>

#### 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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