Skip to content

Installation & Setup

Install the SOMA CLI, create an account, and fund it.

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 SOMA from the faucet:

soma faucet

Check your balance:

soma balance

See what’s happening:

soma status

Shows the current epoch, time till next epoch, and your active address.

soma model list

Lists all registered models with their status, stake, and architecture version.

soma target list

Shows open targets waiting for data submissions, including their distance thresholds and rewards.

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

pip install soma-sdk

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