Installation & Setup

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

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 a Wallet

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 tokens 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 tokens 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.

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 deploy a scoring server, hit a target on testnet, and earn SOMA.