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