nepher-cli 0.2.7__tar.gz → 0.2.8__tar.gz

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/.gitignore

@@ -1,8 +1,8 @@
-.venv/
-__pycache__/
-*.py[cod]
-.ruff_cache/
-.pytest_cache/
-*.egg-info/
-dist/
-build/
+.venv/
+__pycache__/
+*.py[cod]
+.ruff_cache/
+.pytest_cache/
+*.egg-info/
+dist/
+build/

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nepher-cli
-Version: 0.2.7
+Version: 0.2.8
 Summary: npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore
 Project-URL: Homepage, https://github.com/nepher-ai/nepher-cli
 Author: Nepher

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/README.md

@@ -1,149 +1,149 @@
-<div align="center">
-
-# nepher-cli
-
-**The unified CLI for [Nepher Robotics](https://nepher.ai): accounts, tournaments, hackathons, EnvHub and SimStore.**
-
-[![PyPI](https://img.shields.io/pypi/v/nepher-cli)](https://pypi.org/project/nepher-cli/)
-[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](#license)
-
-[Install](#install) •
-[Commands](#commands) •
-[Tournaments](#tournaments) •
-[EnvHub](#envhub) •
-[Hackathons](#hackathons) •
-[Account](#account) •
-[Troubleshooting](#troubleshooting)
-
-</div>
-
----
-
-## Install
-
-```bash
-pip install nepher-cli
-pip install "nepher-cli[bittensor]"   # adds wallet signing for tournament submit and coldkey registration
-```
-
-This installs two equivalent commands, `npcli` and `nepher-cli`.
-
-## Quick start
-
-```bash
-npcli login --api-key nepher_xxxxxxxx
-npcli whoami
-npcli --help
-```
-
-Get your API key at [nepher.ai/account](https://nepher.ai/account) under **API Keys**. In CI/CD, set `NEPHER_API_KEY` instead of logging in.
-
-## Commands
-
-| Command | Description |
-|---|---|
-| `npcli login` / `whoami` / `logout` | Manage authentication |
-| `npcli account` | API keys and coldkey registration |
-| `npcli tournament` | Browse tournaments, check and submit agents, view leaderboards |
-| `npcli envhub` | Manage Isaac Lab environment bundles |
-| `npcli hackathon` | Browse and submit to hackathons |
-| `npcli simstore` | SimStore marketplace (coming soon) |
-
-Run any command with `--help` for all options.
-
-## Tournaments
-
-```bash
-npcli tournament list                  # or list-active
-npcli tournament status <tournament_id>
-npcli tournament leaderboard <tournament_id>
-npcli tournament check --path ./my-agent
-npcli tournament submit --path ./my-agent --wallet-name miner --wallet-hotkey default
-```
-
-`check` validates the agent directory (add `--verbose` for recommended-file warnings). `submit` requires `bittensor-wallet`.
-
-<details>
-<summary>Full <code>tournament submit</code> options</summary>
-
-| Option | Description |
-|---|---|
-| `--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, required when several are active |
-| `--api-url <url>` | Override the tournament API URL |
-| `-v`, `--verbose` | Verbose output |
-
-</details>
-
-## EnvHub
-
-```bash
-npcli envhub list
-npcli envhub download <env_id>
-npcli envhub upload ./my-bundle --category navigation
-npcli envhub cache list | info | clear
-```
-
-Shares login, API and cache with the standalone [`nepher`](https://github.com/nepher-ai/envhub) package.
-
-## Hackathons
-
-```bash
-npcli hackathon list
-npcli hackathon submit --title "My entry" --submission ./my-project --assets ./my-assets
-```
-
-<details>
-<summary>Full <code>hackathon submit</code> options</summary>
-
-| Option | Description |
-|---|---|
-| `--hackathon-id <uuid>` | Required when several 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 |
-
-</details>
-
-## Account
-
-API key management needs a session from `npcli account login`. Don't pass `--api-key` to the `api-keys` commands; the account API rejects `X-API-Key` for key management.
-
-```bash
-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>
-```
-
-Bind a Bittensor coldkey to your account (requires `bittensor-wallet`; `btcli` is not needed):
-
-```bash
-npcli account register-coldkey --wallet <wallet_name>
-```
-
-Keys must start with `nepher_` and be active. `hackathon submit` needs Hackathon scope and `tournament submit` needs Tournament scope, or use an unrestricted key.
-
-## Troubleshooting
-
-| Error | Fix |
-|---|---|
-| `npcli: command not found` | Check the install succeeded and Python's scripts directory is on `PATH` |
-| `Not logged in` | `npcli login --api-key nepher_...` |
-| `invalid api key format` | Key must start with `nepher_` |
-| `api key expired` | Create a new key with `npcli account api-keys create` |
-| `api key does not have hackathon access` | Enable Hackathon scope or use an unrestricted key |
-| `Several hackathons are accepting submissions` | Re-run with `--hackathon-id` |
-| `bittensor-wallet not installed` | `pip install bittensor-wallet` |
-| `Conflict detected: 'scalecodec' ... 'cyscale'` | Leftover `scalecodec` from a Bittensor upgrade. Install `bittensor-wallet` so npcli doesn't need `btcli`, or repair `btcli` with `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
-
-## License
-
-MIT © 2026 Nepher Robotics
+<div align="center">
+
+# nepher-cli
+
+**The unified CLI for [Nepher Robotics](https://nepher.ai): accounts, tournaments, hackathons, EnvHub and SimStore.**
+
+[![PyPI](https://img.shields.io/pypi/v/nepher-cli)](https://pypi.org/project/nepher-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](#license)
+
+[Install](#install) •
+[Commands](#commands) •
+[Tournaments](#tournaments) •
+[EnvHub](#envhub) •
+[Hackathons](#hackathons) •
+[Account](#account) •
+[Troubleshooting](#troubleshooting)
+
+</div>
+
+---
+
+## Install
+
+```bash
+pip install nepher-cli
+pip install "nepher-cli[bittensor]"   # adds wallet signing for tournament submit and coldkey registration
+```
+
+This installs two equivalent commands, `npcli` and `nepher-cli`.
+
+## Quick start
+
+```bash
+npcli login --api-key nepher_xxxxxxxx
+npcli whoami
+npcli --help
+```
+
+Get your API key at [nepher.ai/account](https://nepher.ai/account) under **API Keys**. In CI/CD, set `NEPHER_API_KEY` instead of logging in.
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `npcli login` / `whoami` / `logout` | Manage authentication |
+| `npcli account` | API keys and coldkey registration |
+| `npcli tournament` | Browse tournaments, check and submit agents, view leaderboards |
+| `npcli envhub` | Manage Isaac Lab environment bundles |
+| `npcli hackathon` | Browse and submit to hackathons |
+| `npcli simstore` | SimStore marketplace (coming soon) |
+
+Run any command with `--help` for all options.
+
+## Tournaments
+
+```bash
+npcli tournament list                  # or list-active
+npcli tournament status <tournament_id>
+npcli tournament leaderboard <tournament_id>
+npcli tournament check --path ./my-agent
+npcli tournament submit --path ./my-agent --wallet-name miner --wallet-hotkey default
+```
+
+`check` validates the agent directory (add `--verbose` for recommended-file warnings). `submit` requires `bittensor-wallet`.
+
+<details>
+<summary>Full <code>tournament submit</code> options</summary>
+
+| Option | Description |
+|---|---|
+| `--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, required when several are active |
+| `--api-url <url>` | Override the tournament API URL |
+| `-v`, `--verbose` | Verbose output |
+
+</details>
+
+## EnvHub
+
+```bash
+npcli envhub list
+npcli envhub download <env_id>
+npcli envhub upload ./my-bundle --category navigation
+npcli envhub cache list | info | clear
+```
+
+Shares login, API and cache with the standalone [`nepher`](https://github.com/nepher-ai/envhub) package.
+
+## Hackathons
+
+```bash
+npcli hackathon list
+npcli hackathon submit --title "My entry" --submission ./my-project --assets ./my-assets
+```
+
+<details>
+<summary>Full <code>hackathon submit</code> options</summary>
+
+| Option | Description |
+|---|---|
+| `--hackathon-id <uuid>` | Required when several 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 |
+
+</details>
+
+## Account
+
+API key management needs a session from `npcli account login`. Don't pass `--api-key` to the `api-keys` commands; the account API rejects `X-API-Key` for key management.
+
+```bash
+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>
+```
+
+Bind a Bittensor coldkey to your account (requires `bittensor-wallet`; `btcli` is not needed):
+
+```bash
+npcli account register-coldkey --wallet <wallet_name>
+```
+
+Keys must start with `nepher_` and be active. `hackathon submit` needs Hackathon scope and `tournament submit` needs Tournament scope, or use an unrestricted key.
+
+## Troubleshooting
+
+| Error | Fix |
+|---|---|
+| `npcli: command not found` | Check the install succeeded and Python's scripts directory is on `PATH` |
+| `Not logged in` | `npcli login --api-key nepher_...` |
+| `invalid api key format` | Key must start with `nepher_` |
+| `api key expired` | Create a new key with `npcli account api-keys create` |
+| `api key does not have hackathon access` | Enable Hackathon scope or use an unrestricted key |
+| `Several hackathons are accepting submissions` | Re-run with `--hackathon-id` |
+| `bittensor-wallet not installed` | `pip install bittensor-wallet` |
+| `Conflict detected: 'scalecodec' ... 'cyscale'` | Leftover `scalecodec` from a Bittensor upgrade. Install `bittensor-wallet` so npcli doesn't need `btcli`, or repair `btcli` with `pip uninstall scalecodec cyscale -y && pip install -U cyscale --force-reinstall` |
+
+## License
+
+MIT © 2026 Nepher Robotics

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/pyproject.toml

@@ -1,62 +1,62 @@
-[build-system]
-requires = ["hatchling>=1.27,<1.32"]
-build-backend = "hatchling.build"
-
-[project]
-name = "nepher-cli"
-version = "0.2.7"
-description = "npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore"
-readme = "README.md"
-requires-python = ">=3.10"
-license = { text = "MIT" }
-authors = [{ name = "Nepher" }]
-keywords = ["nepher", "bittensor", "hackathon", "envhub", "cli", "tournament", "subnet"]
-classifiers = [
-  "Development Status :: 4 - Beta",
-  "Environment :: Console",
-  "Intended Audience :: Developers",
-  "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.12",
-]
-dependencies = [
-  "httpx>=0.27.0",
-  "rich>=13.7.0",
-  "click>=8.1.0",
-  "keyring>=25.0.0",
-  "platformdirs>=4.0.0",
-]
-
-[project.optional-dependencies]
-bittensor = ["bittensor-wallet>=4.1.0"]
-dev = [
-  "pytest>=8.0.0",
-  "ruff>=0.4.0",
-]
-
-[project.scripts]
-npcli      = "nepher_cli.cli:main"
-nepher-cli = "nepher_cli.cli:main"
-
-[project.urls]
-Homepage = "https://github.com/nepher-ai/nepher-cli"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/nepher_cli"]
-core-metadata-version = "2.4"
-
-[tool.hatch.build.targets.sdist]
-include = ["src/nepher_cli", "README.md", "pyproject.toml"]
-core-metadata-version = "2.4"
-
-[tool.ruff]
-line-length = 100
-target-version = "py310"
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "UP", "B"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-pythonpath = ["src"]
+[build-system]
+requires = ["hatchling>=1.27,<1.32"]
+build-backend = "hatchling.build"
+
+[project]
+name = "nepher-cli"
+version = "0.2.8"
+description = "npcli — unified Nepher command-line interface for accounts, hackathons, EnvHub, tournaments, and SimStore"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Nepher" }]
+keywords = ["nepher", "bittensor", "hackathon", "envhub", "cli", "tournament", "subnet"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+  "httpx>=0.27.0",
+  "rich>=13.7.0",
+  "click>=8.1.0",
+  "keyring>=25.0.0",
+  "platformdirs>=4.0.0",
+]
+
+[project.optional-dependencies]
+bittensor = ["bittensor-wallet>=4.1.0"]
+dev = [
+  "pytest>=8.0.0",
+  "ruff>=0.4.0",
+]
+
+[project.scripts]
+npcli      = "nepher_cli.cli:main"
+nepher-cli = "nepher_cli.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/nepher-ai/nepher-cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nepher_cli"]
+core-metadata-version = "2.4"
+
+[tool.hatch.build.targets.sdist]
+include = ["src/nepher_cli", "README.md", "pyproject.toml"]
+core-metadata-version = "2.4"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/src/nepher_cli/__init__.py

@@ -1,10 +1,10 @@
-"""npcli — unified Nepher command-line interface."""
-
-from __future__ import annotations
-
-from importlib.metadata import PackageNotFoundError, version
-
-try:
-    __version__ = version("nepher-cli")
-except PackageNotFoundError:  # pragma: no cover
-    __version__ = "0.0.0"
+"""npcli — unified Nepher command-line interface."""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("nepher-cli")
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "0.0.0"

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/src/nepher_cli/__main__.py

@@ -1,4 +1,4 @@
-from nepher_cli.cli import main
-
-if __name__ == "__main__":
-    raise SystemExit(main())
+from nepher_cli.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/src/nepher_cli/cli.py

@@ -1,64 +1,64 @@
-"""npcli — unified Nepher command-line interface."""
-
-from __future__ import annotations
-
-import click
-
-from nepher_cli import __version__
-from nepher_cli.commands.account import account, cmd_login, cmd_logout, cmd_whoami
-from nepher_cli.commands.envhub import envhub
-from nepher_cli.commands.hackathon import hackathon
-from nepher_cli.commands.simstore import simstore
-from nepher_cli.commands.tournament import tournament
-
-
-@click.group(
-    context_settings={"help_option_names": ["-h", "--help"], "max_content_width": 100},
-)
-@click.version_option(version=__version__, package_name="nepher-cli", prog_name="npcli")
-def main() -> None:
-    """npcli — the unified Nepher command-line interface.
-
-    Provides centralized access to all Nepher sub-platforms:
-
-    \b
-      login       Log in with a Nepher API key
-      whoami      Show the currently authenticated user
-      logout      Clear locally stored credentials
-      account     API keys and coldkey registration
-      tournament  Browse tournaments, submit agents, leaderboards
-      envhub      Manage Isaac Lab environment bundles
-      hackathon   Browse and submit to hackathons
-      simstore    SimStore marketplace (coming soon)
-
-    \b
-    Quick start:
-      npcli login --api-key nepher_xxxxxxxx
-      npcli whoami
-      npcli hackathon list
-      npcli envhub list
-      npcli tournament list
-
-    \b
-    Tournament submit requires bittensor-wallet for wallet signing:
-      pip install bittensor-wallet
-      # or: pip install "nepher-cli[bittensor]"
-
-    Run any sub-command with --help for details and examples.
-
-    API keys are created at https://nepher.ai/account (Account > API Keys).
-    """
-
-
-main.add_command(cmd_login, name="login")
-main.add_command(cmd_logout, name="logout")
-main.add_command(cmd_whoami, name="whoami")
-main.add_command(account)
-main.add_command(tournament)
-main.add_command(envhub)
-main.add_command(hackathon)
-main.add_command(simstore)
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())
+"""npcli — unified Nepher command-line interface."""
+
+from __future__ import annotations
+
+import click
+
+from nepher_cli import __version__
+from nepher_cli.commands.account import account, cmd_login, cmd_logout, cmd_whoami
+from nepher_cli.commands.envhub import envhub
+from nepher_cli.commands.hackathon import hackathon
+from nepher_cli.commands.simstore import simstore
+from nepher_cli.commands.tournament import tournament
+
+
+@click.group(
+    context_settings={"help_option_names": ["-h", "--help"], "max_content_width": 100},
+)
+@click.version_option(version=__version__, package_name="nepher-cli", prog_name="npcli")
+def main() -> None:
+    """npcli — the unified Nepher command-line interface.
+
+    Provides centralized access to all Nepher sub-platforms:
+
+    \b
+      login       Log in with a Nepher API key
+      whoami      Show the currently authenticated user
+      logout      Clear locally stored credentials
+      account     API keys and coldkey registration
+      tournament  Browse tournaments, submit agents, leaderboards
+      envhub      Manage Isaac Lab environment bundles
+      hackathon   Browse and submit to hackathons
+      simstore    SimStore marketplace (coming soon)
+
+    \b
+    Quick start:
+      npcli login --api-key nepher_xxxxxxxx
+      npcli whoami
+      npcli hackathon list
+      npcli envhub list
+      npcli tournament list
+
+    \b
+    Tournament submit requires bittensor-wallet for wallet signing:
+      pip install bittensor-wallet
+      # or: pip install "nepher-cli[bittensor]"
+
+    Run any sub-command with --help for details and examples.
+
+    API keys are created at https://nepher.ai/account (Account > API Keys).
+    """
+
+
+main.add_command(cmd_login, name="login")
+main.add_command(cmd_logout, name="logout")
+main.add_command(cmd_whoami, name="whoami")
+main.add_command(account)
+main.add_command(tournament)
+main.add_command(envhub)
+main.add_command(hackathon)
+main.add_command(simstore)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{nepher_cli-0.2.7 → nepher_cli-0.2.8}/src/nepher_cli/commands/__init__.py

@@ -1 +1 @@
-"""npcli command groups."""
+"""npcli command groups."""