# 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="https://2589268311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDdpQIQSF1FubGThe6umC%2Fuploads%2FXnoYQieQMo6LPpgsKoja%2FScreenshot%202026-03-10%20at%2012.58.45%E2%80%AFPM.png?alt=media&#x26;token=42023b52-ec90-4cac-b708-8ab6ef919c99" 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="https://2589268311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDdpQIQSF1FubGThe6umC%2Fuploads%2FGwOfqYiRbsZc0tUUT0SW%2FStepOneGuide.gif?alt=media&#x26;token=af07eaf1-92d8-442e-8cf7-b3f349f0e31d" 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="https://2589268311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDdpQIQSF1FubGThe6umC%2Fuploads%2F0UTHTX7zBjGyqloV94aC%2FStepOnboarding2.gif?alt=media&#x26;token=dcdf8428-7b9c-48ff-aa95-bb1cd0a0f816" alt=""><figcaption></figcaption></figure>

2. **Login to Boba Agents**

```bash
boba
```

{% endcolumn %}

{% column width="33.33333333333334%" %}

<figure><img src="https://2589268311-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDdpQIQSF1FubGThe6umC%2Fuploads%2FwCasDs7nRlZTpHxWLPpw%2FStepOnboarding3.gif?alt=media&#x26;token=ffee89f1-a72c-492e-ae4c-9a7a085f325a" 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>" %}