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

# Quickstart

***

#### Get started in 30 seconds

Below is a streamlined way to get Boba Agents up and running on your system quickly:

<details open>

<summary><strong>Prerequisites:</strong></summary>

* MacOS, Windows or Linux
* NodeJS 18.0.0^ (Needed for the npm installs of the Boba CLI)
* A free registered Boba Agents account with credentials saved securely
* Installed Boba CLI v1.0.0^

</details>

{% hint style="info" %}
Claude subscription no longer required to get started using boba agents.
{% endhint %}

**Install Boba Agents**

To install Boba Agents use one of the following methods below:

{% tabs %}
{% tab title="NPM Install" %}
**macOS, Linux, WSL**

Copy and paste the following command into your terminal or powershell:

```bash
npm install -g @tradeboba/cli
```

{% hint style="info" %}
Native installations will automatically update in the background to keep you on the latest version.
{% endhint %}
{% endtab %}
{% endtabs %}

***

**Start Boba Agents**

To start using boba agents it's really easy just follow the steps below:

{% hint style="warning" %}
Make sure you have installed Boba Agents on your system before the next steps. Install guide is above ↑
{% endhint %}

{% stepper %}
{% step %}

### Open your Terminal

Open a fresh terminal window on your computer (or in your IDE)

{% endstep %}

{% step %}

### NPM Install "@tradeboba/cli"

Copy and paste the following command into your terminal to install:

```bash
npm install -g @tradeboba/cli
```

{% endstep %}

{% step %}

### Open Boba Agents

Copy and paste the following command into your terminal to open the Boba Agent:

```bash
boba
```

{% endstep %}

{% step %}

### Select "login"

Login with your Boba Agent credientials. If you have none, select "No, sign me up".

{% hint style="info" %}
Or - If you want to open Boba Agents in a specific file do use the following command:

```bash
cd your-project
boba
```

{% endhint %}

{% endstep %}

{% step %}

### After you log in with your credentials boba agents will instantly launch&#x20;

<figure><img src="/files/UO5spIoZlGBm1eL1yEc0" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Launch Boba Agents with Claude (Bonus Step)

Copy paste the following command into your terminal, this will also launch Claude for you:

```bash
boba claude 
```

{% endstep %}
{% endstepper %}

{% hint style="success" %}
You're all set! Tag us [@TradeBoba](https://x.com/tradeboba) and share with us how your Boba Agent is performing on X.
{% endhint %}

***

#### Visual Walkthrough

More of a visual learner? Check out our walkthrough below (click them to enlarge):

{% columns fullWidth="true" %}
{% column width="33.33333333333333%" %}

<figure><img src="/files/jP1VnCP9dmKs4SfV6FX4" alt=""><figcaption></figcaption></figure>

1. **Open your terminal**

Open a terminal window on your computer or add one in your IDE.
{% endcolumn %}

{% column width="33.33333333333333%" %}

<figure><img src="/files/eJacupUJ88EAHIzTgPE1" alt=""><figcaption></figcaption></figure>

2. **Login to Boba Agents**

```bash
boba
```

{% endcolumn %}

{% column width="33.33333333333334%" %}

<figure><img src="/files/efamrVK2Aqt5GucawWdb" alt=""><figcaption></figcaption></figure>

3. **Connect to the Boba MCP**

```bash
boba launch
```

{% endcolumn %}
{% endcolumns %}

***

#### Video Guide

Need someone to walk you through the steps one by one? Check out our guide below:

{% embed url="<https://youtu.be/5mRfOMqGjH8>" %}

***

#### Still having trouble?

Join our [Discord](https://discord.gg/tradeboba) and reach out to one of the team members, we're always happy to help! Remember that Boba employee's will never direct message asking for money or wallet credentials.

{% embed url="<https://discord.gg/tradeboba>" %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.boba.xyz/agents/boba-agents/get-started/quickstart.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.