> For the complete documentation index, see [llms.txt](https://docs.macrocosmos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.macrocosmos.ai/~/revisions/KrMJwem2Y231mkGUd91p/subnets/new-subnet-1-apex/subnet-1-base-miner-setup.md).

# Mining

## Miner Documentation

### Overview

**Apex** drives algorithmic innovation across diverse problem domains. Each pursuit of the best solution takes place within a **Competition**, which consists of multiple **Rounds** of evaluation. Participants, known as miners, join Competitions by submitting their Python-based algorithms through the [Apex CLI ](/~/revisions/KrMJwem2Y231mkGUd91p/subnets/new-subnet-1-apex/subnet-1-base-miner-setup/apex-cli.md)and earn rewards based on their performance.

### Prerequisites

To setup a miner on Apex you will need the following:

* A registered [Bittensor wallet](https://docs.bittensor.com/working-with-keys) 

### Setting Up the Environment 

To get started, [clone the repo](https://github.com/macrocosm-os/apex) and run `./install_cli.sh` then activate the environment created by running `source .venv/bin/activate`

### Creating Your Solutions:

Miners are encouraged to review the baseline solutions for available competitions before submitting their own. All baseline solutions and general submission templates can be found in their respective competition folders within `shared/competition/src/competition`.

You should keep all function signatures identical to the baseline to ensure that your submission can be evaluated properly. 

### Submitting Your Solutions

To understand the current competitions and their scoring guidlelines: [Current Competitions](/~/revisions/KrMJwem2Y231mkGUd91p/subnets/new-subnet-1-apex/subnet-1-base-miner-setup/current-competitions.md)

To use the CLI to submit miner solutions, pull previous winning submissions, and view the submission dashboard: [CLI Usage](/~/revisions/KrMJwem2Y231mkGUd91p/subnets/new-subnet-1-apex/subnet-1-base-miner-setup/apex-cli.md)