Skip to content

Installation & Setup

Install the SOMA CLI, create a wallet, and fund your account.

The SOMA CLI is installed via sup, SOMA’s version manager (like rustup).

  1. Install sup:

    curl -sSfL https://sup.soma.org | sh
  2. Install SOMA:

    sup install soma
  3. Verify:

    soma --version

If you get “command not found,” add the SOMA binaries directory to your PATH.

soma wallet new --alias my-wallet

This returns your address and a 12-word recovery phrase.

Check your active address:

soma wallet active

SOMA has two environments: testnet (the default public test network) and localnet (a local network for development, see Local Network).

View available environments:

soma env list

Switch environments:

soma env switch testnet

On testnet or localnet, request tokens from the faucet:

soma faucet

Check your balance:

soma balance

If you plan to interact with SOMA programmatically, install the Python SDK:

pip install soma-sdk

Next, run through the Quickstart to deploy a scoring server, hit a target on testnet, and earn SOMA.