# Quick Start

## Prerequisites:

Before getting started with SONA, ensure you have:

* [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) (using [nvm](https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating) is recommended)
* [pnpm 9+](https://pnpm.io/installation)
* Git for version control
* A code editor ([VS Code](https://code.visualstudio.com/), [Cursor](https://cursor.com/) or [VSCodium](https://vscodium.com/) recommended)
* Python (mainly for installing NPM)
* (Optional) FFmpeg (for audio/video handling)
* (Optional) [CUDA Toolkit](https://developer.nvidia.com/cuda-toolkit) (for GPU acceleration)

> On Windows? See here before continuing to make life easier: [WSL setup guide](https://elizaos.github.io/eliza/docs/guides/wsl)

## Automated Installation:

1. Use [https://github.com/](https://github.com/elizaOS/eliza-starter)tars-sol/sona

```
git clone git@github.com/tars-sol/sona.git
cd sona
cp .env.example .env
pnpm i && pnpm build && pnpm start
```

2. Use the start script

```
// after cloning and cd
./scripts/start.sh
```

3. Using Docker

Prerequisites:

* A Linux-based server (Ubuntu/Debian recommended)
* Git installed
* [Docker](https://docs.docker.com/get-started/get-docker/)

```
// after cloning and cd
docker-compose build
docker-compose up
```

Note: If you get permission issues run the docker-compose commands with sudo or add yourself to the docker group

## Start SONA:

SONA derived it's character and lore capabilities from ElizaOS. So in order to start your agent, you can provide your character.json file.

```
pnpm start --character="characters/deep-thought.character.json"
```

By default agent will be accessible via CLI and APIs too. 

## Additional Config:

Add plugins and protocols:

```json
{
    "name": "Rainmaker",
    "protocols": ["uniswap", "raydium"],
    // ... other config options
    "plugins": ["@sona/plugin-limit-order"],
}
```

There are two ways to get a list of available plugins:

1. Web Interface

Go [https://github.com/tars-sol/sona/registry/](https://elizaos.github.io/registry/) or the Showcase and search for plugins

2. CLI Interface

```sh
npx elizaos plugins list

```

| Plugin Name                |
| -------------------------- |
| @sona/plugin-limit-order   |
| @sona/plugin-swap-evm      |
| @sona/plugin-swap-raydium  |
| @sona/plugin-trade-pumpfun |
| @sona/plugin-dex-liquidity |
| @sona/plugin-oracle-prices |


---

# 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.tars.pro/sona-framework/getting-started/quick-start.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.