Installation & Setup

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

Supported Operating Systems

• Linux: Ubuntu 22.04 or newer
• macOS: Monterey or newer
• Windows: 10 or 11

Install

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

1. Install sup:

   Script

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

   Cargo

   cargo install --git https://github.com/soma-org/sup.git --locked

2. Install SOMA:

   sup install soma

3. Verify:

   soma --version

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

Create an Account

soma wallet new --alias my-wallet

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

Danger

Recovery phrases are shown once. Store them securely and do not share them. They control access to all objects and SOMA the address owns.

Check your active address:

soma wallet active

Connect to a Network

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

Fund Your Account

On testnet or localnet, request SOMA from the faucet:

soma faucet

Check your balance:

soma balance

Note

Balances are denominated in shannons. 1 SOMA = 1,000,000,000 shannons.

Danger

SOMA stores private keys in ~/.soma/soma_config/soma.keystore. Keep this file secure and do not share it.

Explore the Network

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.

Python SDK

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

pip

pip install soma-sdk

uv

uv add soma-sdk

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