# 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`:

    ```
            curl -sSfL https://sup.soma.org | sh
            ```
        ```
            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](https://docs.soma.org/guides/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 install soma-sdk
        ```
    ```
        uv add soma-sdk
        ```
    Next, [run through the Quickstart](https://docs.soma.org/getting-started/quickstart/) to hit a target on testnet and earn SOMA.