Install the Apex CLI
Clone the official repository and run its installer. The script installs uv, syncs the workspace, and exposes the apex command.
git clone https://github.com/macrocosm-os/apex.git
cd apex
./install_cli.sh
apex --helpPick a subnet below — from beginner-friendly options to advanced GPU compute. BlueTAO will walk you through setup, hardware, registration, and getting your miner scoring — step by step.
Compete by building the best algorithm or model for open intelligence challenges.
Route inference requests through an adapter — no GPU required.
Compete with portfolio strategies — no ML engineering needed.
Well-documented onboarding that rewards model quality over raw compute.
Serverless GPU compute — host AI models and serve inference at scale.
Deterministic verified inference — fast, low-latency LLM serving.
Verification and validation of AI outputs across the network.
Apex is not a conventional always-on miner. You choose a measurable competition, improve its baseline solution, submit your file, and compete for the highest score.
Linux, macOS, or Windows through WSL2. Python 3.12+ and Git.
A Bittensor coldkey and hotkey, plus enough TAO for registration and submission fees.
Python, model, or structured solution files that match a competition specification.
Protect your wallet. Never paste a mnemonic, coldkey file, or password into BlueTAO, Discord, GitHub, or any website. Store recovery words offline. Each competition can charge a submission fee, so confirm the displayed TAO cost before approving.
Clone the official repository and run its installer. The script installs uv, syncs the workspace, and exposes the apex command.
git clone https://github.com/macrocosm-os/apex.git
cd apex
./install_cli.sh
apex --helpCreate one coldkey and a hotkey that will sign submissions. Replace the example names with your own.
uv run btcli wallet new_coldkey --wallet.name my-apex-wallet
uv run btcli wallet new_hotkey --wallet.name my-apex-wallet --wallet.hotkey miner1
uv run btcli wallet balance --wallet.name my-apex-walletRegistration is the one-time on-chain entry for your hotkey. The CLI shows the current TAO cost before confirmation.
uv run btcli subnet register \
--wallet.name my-apex-wallet --wallet.hotkey miner1 \
--netuid 1Choose the wallet and registered hotkey when prompted. Authentication may take a few minutes after a new registration.
apex link
apex competitionsInspect active competitions, then read that competition’s README and baseline before writing code. Requirements and fees vary.
apex competitions
apex competitions -c <COMPETITION_ID>
apex docs -cStart from the supplied baseline, test locally, and submit only when it matches the required interface. Save the returned submission ID.
apex submit path/to/solution.py -c <COMPETITION_ID>Compare your entry with the leaderboard, inspect result details, and improve deliberately. Apex rewards the top-ranked solution for each competition.
apex list -c <COMPETITION_ID> -m
apex list -c <COMPETITION_ID> -t
apex result <SUBMISSION_ID>
apex dashboardAdd ~/.local/bin to PATH, restart the shell, then run apex --help.
Confirm the linked hotkey is registered on netuid 1, then wait several minutes and retry.
Run apex link again from your Apex working directory and select the registered hotkey.
The guided chat starts by checking your operating system, tools, wallet, and experience.
Heads up: easy to start does not mean guaranteed profit. Registration costs TAO and the top miners earn most emissions. BlueTAO will help you understand the economics before you commit.