nepher-cli 0.2.0__tar.gz

nepher_cli-0.2.0/.gitignore

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

nepher_cli-0.2.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: nepher-cli
+Version: 0.2.0
+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
+License: MIT
+Keywords: bittensor,cli,envhub,hackathon,nepher,subnet,tournament
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: rich>=13.7.0
+Provides-Extra: bittensor
+Requires-Dist: bittensor; extra == 'bittensor'
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# nepher-cli
+
+The unified CLI for [Nepher Robotics](https://nepher.ai) — accounts, hackathons, EnvHub, tournaments, and SimStore from a single tool.
+
+**Requires:** Python 3.10+
+
+## Install
+
+```bash
+pip install nepher-cli
+```
+
+Both `npcli` and `nepher-cli` entry points are registered after install.
+
+```bash
+npcli --version
+npcli --help
+```
+
+## Commands
+
+| 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, submit agents, leaderboards |
+| `npcli envhub` | Manage Isaac Lab environment bundles |
+| `npcli hackathon` | Browse and submit to hackathons |
+| `npcli simstore` | SimStore marketplace *(coming soon)* |
+
+## Quick Start
+
+### Authenticate
+
+```bash
+npcli login --api-key nepher_xxxxxxxx
+npcli whoami
+npcli logout
+```
+
+Get your API key at [account.nepher.ai](https://account.nepher.ai) → Account → API Keys.  
+For CI/CD, set `NEPHER_API_KEY=nepher_xxxxxxxx` instead of logging in.
+
+### Tournaments
+
+```bash
+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):
+
+```bash
+npcli tournament check --path ./my-agent
+npcli tournament check --path ./my-agent --verbose   # also show recommended-file warnings
+```
+
+Submit an agent (requires `bittensor` for wallet signing):
+
+```bash
+pip install bittensor
+# or: pip install "nepher-cli[bittensor]"
+```
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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 account (requires `bittensor` + `btcli` on PATH):
+
+```bash
+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)
+
+## 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:
+
+```bash
+npcli --help
+npcli hackathon submit --help
+npcli tournament submit --help
+```
+
+## License
+
+MIT

nepher_cli-0.2.0/README.md

@@ -0,0 +1,165 @@
+# nepher-cli
+
+The unified CLI for [Nepher Robotics](https://nepher.ai) — accounts, hackathons, EnvHub, tournaments, and SimStore from a single tool.
+
+**Requires:** Python 3.10+
+
+## Install
+
+```bash
+pip install nepher-cli
+```
+
+Both `npcli` and `nepher-cli` entry points are registered after install.
+
+```bash
+npcli --version
+npcli --help
+```
+
+## Commands
+
+| 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, submit agents, leaderboards |
+| `npcli envhub` | Manage Isaac Lab environment bundles |
+| `npcli hackathon` | Browse and submit to hackathons |
+| `npcli simstore` | SimStore marketplace *(coming soon)* |
+
+## Quick Start
+
+### Authenticate
+
+```bash
+npcli login --api-key nepher_xxxxxxxx
+npcli whoami
+npcli logout
+```
+
+Get your API key at [account.nepher.ai](https://account.nepher.ai) → Account → API Keys.  
+For CI/CD, set `NEPHER_API_KEY=nepher_xxxxxxxx` instead of logging in.
+
+### Tournaments
+
+```bash
+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):
+
+```bash
+npcli tournament check --path ./my-agent
+npcli tournament check --path ./my-agent --verbose   # also show recommended-file warnings
+```
+
+Submit an agent (requires `bittensor` for wallet signing):
+
+```bash
+pip install bittensor
+# or: pip install "nepher-cli[bittensor]"
+```
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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 account (requires `bittensor` + `btcli` on PATH):
+
+```bash
+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)
+
+## 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:
+
+```bash
+npcli --help
+npcli hackathon submit --help
+npcli tournament submit --help
+```
+
+## License
+
+MIT

nepher_cli-0.2.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "nepher-cli"
+version = "0.2.0"
+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"]
+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"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/nepher_cli", "README.md", "pyproject.toml"]
+
+[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.0/src/nepher_cli/__init__.py

@@ -0,0 +1,3 @@
+"""npcli — unified Nepher command-line interface."""
+
+__version__ = "0.2.0"

nepher_cli-0.2.0/src/nepher_cli/__main__.py

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

nepher_cli-0.2.0/src/nepher_cli/cli.py

@@ -0,0 +1,59 @@
+"""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__, 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
+
+    Run any sub-command with --help for details and examples.
+
+    API keys are created at https://account.nepher.ai (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.0/src/nepher_cli/commands/__init__.py

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