nepher-cli 0.2.0__py3-none-any.whl

nepher_cli/tournament/api.py

@@ -0,0 +1,100 @@
+"""Tournament submission API calls — httpx only, no external dependencies."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+import httpx
+
+from nepher_cli.core.http import parse_error_body
+
+_DEFAULT_TIMEOUT = 30.0
+_UPLOAD_TIMEOUT = 600.0  # 10 min — large agent ZIPs can be slow
+
+
+def _json_headers(api_key: str) -> dict[str, str]:
+    return {
+        "X-API-Key": api_key,
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+    }
+
+
+def _raise_for_error(response: httpx.Response) -> None:
+    if response.status_code < 400:
+        return
+    msg = (
+        parse_error_body(response.text)
+        or response.text.strip()
+        or f"HTTP {response.status_code}"
+    )
+    raise RuntimeError(msg)
+
+
+async def request_upload_token(
+    *,
+    api_key: str,
+    api_url: str,
+    miner_hotkey: str,
+    public_key: str,
+    file_info: str,
+    signature: str,
+    file_size: int,
+    tournament_id: str | None = None,
+) -> dict[str, Any]:
+    """POST /api/v1/agents/upload/verify → parsed JSON token dict.
+
+    The returned dict contains at least ``upload_token`` and ``tournament_id``.
+    """
+    body: dict[str, Any] = {
+        "miner_hotkey": miner_hotkey,
+        "public_key": public_key,
+        "file_info": file_info,
+        "signature": signature,
+        "file_size": file_size,
+    }
+    if tournament_id is not None:
+        body["tournament_id"] = tournament_id
+
+    url = f"{api_url.rstrip('/')}/api/v1/agents/upload/verify"
+    async with httpx.AsyncClient(
+        timeout=_DEFAULT_TIMEOUT,
+        headers=_json_headers(api_key),
+    ) as client:
+        response = await client.post(url, json=body)
+    _raise_for_error(response)
+    return response.json()
+
+
+async def upload_agent(
+    *,
+    api_key: str,
+    api_url: str,
+    tournament_id: str,
+    upload_token: str,
+    miner_hotkey: str,
+    content_hash: str,
+    file_path: Path,
+) -> str:
+    """POST /api/v1/agents/upload/{tournament_id} (multipart) → agent_id string."""
+    url = f"{api_url.rstrip('/')}/api/v1/agents/upload/{tournament_id}"
+    headers = {
+        "X-API-Key": api_key,
+        "Accept": "application/json",
+        "X-Upload-Token": upload_token,
+    }
+    async with httpx.AsyncClient(timeout=httpx.Timeout(_UPLOAD_TIMEOUT)) as client:
+        with open(file_path, "rb") as fh:
+            response = await client.post(
+                url,
+                files={"file": (file_path.name, fh, "application/zip")},
+                data={"miner_hotkey": miner_hotkey, "content_hash": content_hash},
+                headers=headers,
+            )
+    _raise_for_error(response)
+    data = response.json()
+    agent_id = data.get("id") or data.get("agent_id")
+    if not agent_id:
+        raise RuntimeError(f"No agent ID in upload response: {data}")
+    return str(agent_id)

nepher_cli/tournament/packer.py

@@ -0,0 +1,50 @@
+"""Archive and checksum helpers — pure Python stdlib, no external dependencies."""
+
+from __future__ import annotations
+
+import hashlib
+import zipfile
+from pathlib import Path
+
+# Names and suffixes excluded from submission archives
+_EXCLUDED_NAMES: frozenset[str] = frozenset({
+    "__pycache__", ".git", ".gitignore",
+    "logs", "outputs", ".env", "venv", ".venv", "node_modules",
+})
+_EXCLUDED_SUFFIXES: frozenset[str] = frozenset({".pyc", ".pyo"})
+
+
+def _is_excluded(path_part: str) -> bool:
+    p = Path(path_part)
+    return p.name in _EXCLUDED_NAMES or p.suffix in _EXCLUDED_SUFFIXES
+
+
+def zip_directory(source_dir: Path, output_path: Path) -> None:
+    """Create a ZIP archive of *source_dir* at *output_path*.
+
+    Files are added in sorted order for reproducibility. Common
+    build artefacts and VCS directories are excluded automatically.
+    """
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    with zipfile.ZipFile(output_path, "w", zipfile.ZIP_DEFLATED) as zf:
+        for file_path in sorted(source_dir.rglob("*")):
+            if not file_path.is_file():
+                continue
+            rel = file_path.relative_to(source_dir)
+            if any(_is_excluded(part) for part in rel.parts):
+                continue
+            zf.write(file_path, rel)
+
+
+def compute_checksum(file_path: Path) -> str:
+    """Return the SHA-256 hex digest of *file_path*."""
+    h = hashlib.sha256()
+    with open(file_path, "rb") as f:
+        for chunk in iter(lambda: f.read(8192), b""):
+            h.update(chunk)
+    return h.hexdigest()
+
+
+def get_file_size(file_path: Path) -> int:
+    """Return the size of *file_path* in bytes."""
+    return file_path.stat().st_size

nepher_cli/tournament/wallet.py

@@ -0,0 +1,89 @@
+"""Bittensor wallet operations — lazy import so bittensor is an optional dependency."""
+
+from __future__ import annotations
+
+import time
+
+_BITTENSOR_HINT = (
+    "Agent submission requires [bold]bittensor[/bold] for wallet signing.\n\n"
+    "Install it with:\n"
+    "  [bold]pip install bittensor[/bold]\n\n"
+    "Or if you installed nepher-cli via pip:\n"
+    "  [bold]pip install \"nepher-cli[bittensor]\"[/bold]"
+)
+
+
+def _require_wallet_class():
+    """Return the ``bittensor_wallet.Wallet`` class or exit with a clear error.
+
+    ``bittensor_wallet`` is a standalone package that is installed automatically
+    as a dependency of ``bittensor``. Importing it directly keeps the check
+    lightweight — we do not need the full bittensor package at import time.
+    """
+    try:
+        from bittensor_wallet import Wallet  # type: ignore[import]
+        return Wallet
+    except ImportError:
+        from rich.console import Console
+        Console(stderr=True).print(
+            f"[red]bittensor not installed.[/red]\n\n{_BITTENSOR_HINT}"
+        )
+        raise SystemExit(1)
+
+
+def load_wallet(wallet_name: str, wallet_hotkey: str):
+    """Load a Bittensor wallet by name and hotkey name.
+
+    Exits with a user-friendly message if bittensor is not installed or the
+    hotkey file does not exist on this machine.
+    """
+    Wallet = _require_wallet_class()
+    wallet = Wallet(name=wallet_name, hotkey=wallet_hotkey)
+    if not wallet.hotkey_file.exists_on_device():
+        from rich.console import Console
+        Console(stderr=True).print(
+            f"[red]Hotkey '[bold]{wallet_hotkey}[/bold]' not found "
+            f"for wallet '[bold]{wallet_name}[/bold]'.[/red]\n"
+            "Check the wallet name and hotkey with [bold]btcli wallet list[/bold]."
+        )
+        raise SystemExit(1)
+    return wallet
+
+
+def get_hotkey(wallet) -> str:
+    """Return the SS58 address of the wallet's hotkey."""
+    return wallet.hotkey.ss58_address
+
+
+def get_public_key(wallet) -> str:
+    """Return the hex-encoded public key of the wallet's hotkey."""
+    return wallet.hotkey.public_key.hex()
+
+
+def sign_message(wallet, message: str) -> str:
+    """Sign *message* with the wallet's hotkey and return a hex-encoded signature."""
+    return wallet.hotkey.sign(message.encode()).hex()
+
+
+def create_file_info(miner_hotkey: str, content_hash: str, timestamp: int) -> str:
+    """Build the canonical file_info string: ``'hotkey:content_hash:timestamp'``."""
+    return f"{miner_hotkey}:{content_hash}:{timestamp}"
+
+
+def prepare_submission_credentials(
+    wallet_name: str,
+    wallet_hotkey: str,
+    content_hash: str,
+) -> tuple[str, str, str, str]:
+    """Load wallet and produce all signing artefacts needed for a submission.
+
+    Returns:
+        ``(miner_hotkey, public_key, file_info, signature)``
+    """
+    wallet = load_wallet(wallet_name, wallet_hotkey)
+    miner_hotkey = get_hotkey(wallet)
+    public_key = get_public_key(wallet)
+    timestamp = int(time.time())
+    file_info = create_file_info(miner_hotkey, content_hash, timestamp)
+    signature = sign_message(wallet, file_info)
+    return miner_hotkey, public_key, file_info, signature

nepher_cli-0.2.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,26 @@
+nepher_cli/__init__.py,sha256=L11vbIe673ZKYNG-FDL_KhGKcTmharqE6PQS9Wo-Rrw,81
+nepher_cli/__main__.py,sha256=FMYmbifGU7eWdjSmv0RXSgXUO0EGzqsMkn2AA2dAws4,93
+nepher_cli/cli.py,sha256=LUCi6ZjpcAjPiUKvKyabddASUoddzLK2aVJ3s5eqP3c,1873
+nepher_cli/config.py,sha256=u3-D3XVSpmu_QCXaVqN7A4gXI5tkCp5P66M2SrWrscw,916
+nepher_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nepher_cli/commands/__init__.py,sha256=JXNTkej-suvV6Jc3JD0EbB1gd1tN4kRpghV9_B4Smj4,29
+nepher_cli/commands/account.py,sha256=F76UrcCakYBYT9w-gGCaz66XrEFDlUEGCtLqPKQrtwA,19574
+nepher_cli/commands/envhub.py,sha256=EapZjDahWwLFxHA5hWKGIJQkOJoLBlvzjaKjVZtOI2g,17984
+nepher_cli/commands/hackathon.py,sha256=8YtoW-w9nmNbEN1hfmQwVNGeIkJXCLR5u5TT_8LiQHE,29042
+nepher_cli/commands/simstore.py,sha256=8lrUIQEZzynPzQMWN9K8TWwoSWUUYBTPRO4NUTzi-OY,1339
+nepher_cli/commands/tournament.py,sha256=pg4ZcriLZjF9lwJID4XK3-hwTWqVU8TLGyU_KKSN1C8,25374
+nepher_cli/core/__init__.py,sha256=9XoS2YWSa28pFNeSvj0lQ6qcprhgXKVmwUZyQck0F44,55
+nepher_cli/core/credentials.py,sha256=i6HLNLkawydJnzpjw_YRGqcMu5P3CvIuq8vsdKBwmhk,6723
+nepher_cli/core/http.py,sha256=gGwIqd-rTSYASmwhSwamK6ksNUPTc3cmNztJzmer47M,2497
+nepher_cli/envhub/__init__.py,sha256=l-VLi2YioXuRRJiJc7qfQlyaHIreQB30OXAENRjsl6M,64
+nepher_cli/envhub/cache.py,sha256=fTxSdk3Kf4rbTD93juhUFhMNN7K4JK3lKCBDjJKMp90,1815
+nepher_cli/envhub/config.py,sha256=Fa8KcihM9X5rW4xqz1ppzHUDjenn5o-bGGfpeGf-LvE,5395
+nepher_cli/tournament/__init__.py,sha256=o-Ap1Pke9Gq4LrcQd33GP5Gu8o3K8amiXMRhDgM8Gbk,65
+nepher_cli/tournament/agent_check.py,sha256=9k92L4e49Np54IDHEzIpKI0xjbDyY7YCU6hqNoYl3iU,2229
+nepher_cli/tournament/api.py,sha256=141yi2elQ3bJB68m26kICMurT7uE9ewLhSxdpSTeeBo,2957
+nepher_cli/tournament/packer.py,sha256=Xa6HMFjP5bRLDGr2Cws8DJFrQZoNCNBnWenVrjkQAjI,1742
+nepher_cli/tournament/wallet.py,sha256=tfeUA7YOWr7GW0zMXVlaXDAIGxRw8wBLwFNcPOxwmwI,3250
+nepher_cli-0.2.0.dist-info/METADATA,sha256=6_zB4KiNtO65Bzr8KihUpDrvi-GY67X3OXdCTISmHGU,5463
+nepher_cli-0.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+nepher_cli-0.2.0.dist-info/entry_points.txt,sha256=QQ1l07o9WxwntxuU1K3Hnz7nRc0fFKRBRMAHJlkjfEQ,79
+nepher_cli-0.2.0.dist-info/RECORD,,

nepher_cli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

nepher_cli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+nepher-cli = nepher_cli.cli:main
+npcli = nepher_cli.cli:main