> ## Documentation Index
> Fetch the complete documentation index at: https://docs.silvana.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Silvana Book Agent Quickstart

# Installation

Follow this guide to start using Silvana Book Agent.

1. Download the latest `cloud-agent` binary from the [GitHub Releases page](https://github.com/SilvanaOne/silvana-book-agent/releases/latest):
   | **Platform**        | **Archive**                        |
   | :------------------ | :--------------------------------- |
   | macOS Apple Silicon | `cloud-agent-macos-silicon.tar.gz` |
   | Linux x86\_64       | `cloud-agent-x86_64-linux.tar.gz`  |
   | Linux ARM64         | `cloud-agent-arm64-linux.tar.gz`   |

See example below:

```text theme={null}
macOS Apple Silicon
curl -LO https://github.com/SilvanaOne/silvana-book-agent/releases/latest/download/cloud-agent-macos-silicon.tar.gz
tar -xzf cloud-agent-macos-silicon.tar.gz
chmod +x cloud-agent
./cloud-agent --help
```

Checksums for all archives are in `checksums.txt` on the release page.

2. Build from source.

```text theme={null}
cargo build --release -p cli
```

Binary at `target/release/cloud-agent`.

3. Onboard. This flow is automatic. Go [here ](/sdk/reference/agent-onboarding)to see how it runs. Example:
   ```text theme={null}
   cloud-agent onboard \
     --agent-name my-agent \
     --email me@example.com \
     --invite-code INVITE1
   ```
   Default RPC is `https://orderbook-devnet.silvana.dev:443` — override with `--rpc`.

# Operations

Now you're good to go. The following operations are available, and how to launch them:

## Faucet

To use the faucet, run this command:

```text theme={null}
cloud-agent faucet get --token CC      # 10,000 CC
cloud-agent faucet get --token USDC    # 1,000 USDC
cloud-agent info balance
```

## Buy CC via RFQ

Requests a quote on the `CC-USDC` market, accepts the best offer, and settles atomically via a single multicall. Repeats until the full amount is filled.

```text theme={null}
cloud-agent buy --market CC-USDC --amount 15
```

## Sell CC via RFQ

Request selling CC by running this command:

```text theme={null}
cloud-agent sell --market CC-USDC --amount 100
```

## Run as LP / market-maker

This is a long-running mode. It places grid orders on configured markets, responds to incoming RFQs, and settles DVPs end-to-end.

<Tip>
  Configured via `agent.toml`
</Tip>

To run as LP/Market-maker, enter this command:

```text theme={null}
cloud-agent agent
```

<Check>
  Use the docs below for reference to guide you as you build on Silvana.
</Check>

<CardGroup cols={2}>
  <Card title="Prerequisites" href="/sdk/reference/configuration">
    See what you need to start building on Silvana.
  </Card>

  <Card title="Agent Onboarding" href="/sdk/reference/agent-onboarding">
    Learn the agent onboarding flow under the hood.
  </Card>

  <Card title="Configuration" href="/sdk/reference/configuration">
    Silvana Book Agent config doc. Nice to have for agent onboarding.
  </Card>

  <Card title="CLI Reference" href="/sdk/reference/full-cli-reference">
    A full list of CLI commands to get an agent running.
  </Card>

  <Card title="SDK Interaction Flow" href="/sdk/reference/sdk-interaction-flow">
    Read about the transaction mechanics in Silvana Book.
  </Card>

  <Card title="Trading Modes" href="/sdk/reference/trading-modes">
    Find out about the supported trading modes – Grid, RFQ, and Taker Loops.
  </Card>

  <Card title="Authentication and Signing" href="/sdk/reference/authentication-and-signature">
    Study the guidelines for authentication and signing.
  </Card>

  <Card title="Security Model" href="/sdk/reference/security-model">
    Get to know Silvana Book's security arrangements and practices.
  </Card>
</CardGroup>