Nepher CLI

The Nepher CLI (nepher-cli) is the unified command-line tool for Nepher Robotics — accounts, tournaments, EnvHub, hackathons, and SimStore from a single install.

Repository: github.com/nepher-ai/nepher-cli

Requires: Python 3.10+

Install

pip install nepher-cli

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

npcli --version
npcli --help

For tournament submission (wallet signing), also install Bittensor:

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

Command Overview

Command / Group	Description
npcli login	Log in with a Nepher API key
npcli whoami	Show the currently authenticated user
npcli logout	Clear locally stored credentials
npcli account	API keys and coldkey registration
npcli tournament	Browse tournaments, validate agents, submit, leaderboards
npcli envhub	Manage Isaac Lab environment bundles
npcli hackathon	Browse and submit to hackathons
npcli simstore	SimStore marketplace (coming soon)

Authenticate

npcli login --api-key nepher_xxxxxxxx
npcli whoami

Get your API key at account.nepher.ai → 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>

Validate agent structure before submitting:

npcli tournament check --path ./my-agent
npcli tournament check --path ./my-agent --verbose

Submit an agent:

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

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

See the Miner Guide for the full workflow using task-spot-waypointnav and eval-nav.

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

See EnvHub for platform details.

Hackathons

npcli hackathon list

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

See Hackathons for submission requirements and voting.

Account & API Keys

npcli account api-keys list
npcli account api-keys create --name "CI key" --platform hackertone
npcli account api-keys revoke <key_id>

Coldkey Registration

Bind a Bittensor coldkey to your Nepher account:

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

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)

Legacy: nepher-subnet CLI

The nepher-subnet repo also provides nepher-miner and nepher-validator for Docker-based validator deployments and advanced subnet operations. For most miners, npcli tournament submit is the recommended path.

Tool	When to use
npcli	Day-to-day: login, EnvHub, tournament submit, hackathons
nepher-miner	Docker submission flows, legacy configs
nepher-validator	Running Subnet 49 validators (Validator Guide)

Troubleshooting

Error	Fix
npcli: command not found	Ensure pip install succeeded and Python scripts dir is on PATH
invalid api key format	Key must start with nepher_
api key does not have hackathon access	Enable Hackathon scope or use an unrestricted key
api key expired	Run npcli account api-keys create
Several hackathons are accepting submissions	Re-run with --hackathon-id
bittensor not installed	pip install bittensor (only needed for tournament submit)
Not logged in	npcli login --api-key nepher_...

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

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

License

MIT — see nepher-cli LICENSE.