nepher-cli

The unified CLI for Nepher Robotics — accounts, hackathons, EnvHub, tournaments, and SimStore from a single tool.

Requires: Python 3.10+

Install

pip install nepher-cli

Both npcli and nepher-cli entry points are registered after install.

npcli --version
npcli --help

Commands

Quick Start

Authenticate

npcli login --api-key nepher_xxxxxxxx
npcli whoami
npcli logout

Get your API key at nepher.ai/account → Account → API Keys.
For CI/CD, set NEPHER_API_KEY=nepher_xxxxxxxx instead of logging in.

Tournaments

npcli tournament list
npcli tournament list-active
npcli tournament status <tournament_id>
npcli tournament leaderboard <tournament_id>

Check your agent directory structure (no extra dependencies needed):

npcli tournament check --path ./my-agent
npcli tournament check --path ./my-agent --verbose   # also show recommended-file warnings

Submit an agent (requires bittensor-wallet for wallet signing):

pip install bittensor-wallet
# or: pip install "nepher-cli[bittensor]"

npcli tournament submit --path ./my-agent --wallet-name miner --wallet-hotkey default

Full options for submit:

--path <path>               Agent directory
--wallet-name <str>         Bittensor wallet name (default: miner)
--wallet-hotkey <str>       Bittensor wallet hotkey (default: default)
--api-key <key>             Nepher API key (falls back to stored credentials)
--tournament-id <id>        Target tournament ID (required when multiple are active)
--api-url <url>             Override tournament API URL
-v / --verbose              Verbose output

EnvHub

npcli envhub list
npcli envhub download <env_id>
npcli envhub upload ./my-bundle --category navigation
npcli envhub cache list
npcli envhub cache info
npcli envhub cache clear

Hackathons

npcli hackathon list

npcli hackathon submit \
  --title "My entry" \
  --submission ./my-project \
  --assets ./my-assets

Full options:

--hackathon-id <uuid>       Required when multiple hackathons are open
--title <str>               Entry title
--description <markdown>    Entry description
--thumbnail <file>          Cover image (JPEG, PNG, WebP, GIF)
--submission <path>         Project folder or submission.zip
--assets <path>             Assets folder or assets.zip (images, videos, PDFs)
--public-source             Mark source as public

API Keys

list / create / revoke need a JWT session from npcli account login.
Do not pass --api-key on these commands (that flag sends X-API-Key, which the account API rejects for key management).

npcli account login --api-key nepher_...
npcli account api-keys list
npcli account api-keys create --name "CI key" --platform hackathon
npcli account api-keys revoke <key_id>

Coldkey Registration

Bind a Bittensor coldkey to your account (requires bittensor-wallet; btcli is optional fallback):

pip install bittensor-wallet
npcli account register-coldkey --wallet <wallet_name>

Signing uses the local coldkey via bittensor-wallet and does not import btcli. If you still have a mixed Bittensor venv (scalecodec + cyscale), register-coldkey keeps working as long as bittensor-wallet is installed.

API Key Requirements

• Must start with nepher_
• Must be active and not expired
• hackathon submit requires Hackathon scope (or an unrestricted key)
• tournament submit requires Tournament scope (or an unrestricted key)

Troubleshooting

Run any command with --help for full flag details:

npcli --help
npcli hackathon submit --help
npcli tournament submit --help

License

MIT