@inference/cli 0.0.1

package/README.md

@@ -0,0 +1,175 @@
+# @inference/cli
+
+Command-line interface for [Inference.net](https://inference.net) -- manage training runs, evals, datasets, and inferences from your terminal.
+
+## Installation
+
+**Via npm (recommended):**
+
+```bash
+npm install -g @inference/cli
+```
+
+**Via npx (no install):**
+
+```bash
+npx @inference/cli --help
+```
+
+**Via Bun:**
+
+```bash
+bunx @inference/cli --help
+```
+
+### Supported Platforms
+
+| Platform | Architecture          | Package                       |
+| -------- | --------------------- | ----------------------------- |
+| macOS    | Apple Silicon (arm64) | `@inference/cli-darwin-arm64` |
+| macOS    | Intel (x64)           | `@inference/cli-darwin-x64`   |
+| Linux    | x64                   | `@inference/cli-linux-x64`    |
+| Linux    | arm64                 | `@inference/cli-linux-arm64`  |
+
+The correct binary is installed automatically based on your platform.
+
+## Quick Start
+
+```bash
+# Sign in via browser
+inf auth login
+
+# List your projects
+inf project list
+
+# Select a project
+inf project switch <project-id>
+
+# View recent training runs
+inf training list
+
+# Launch interactive dashboard
+inf dashboard
+```
+
+## Commands
+
+### Authentication
+
+```bash
+inf auth login          # Sign in via browser (device authorization flow)
+inf auth logout         # Sign out and clear stored credentials
+inf auth status         # Show current authentication status
+inf auth set-key <key>  # Set an API key for CI/headless use (sk-observability-*)
+```
+
+### Projects
+
+```bash
+inf project list        # List all projects
+inf project switch <id> # Set the active project
+inf project current     # Show the currently active project
+```
+
+### Training
+
+```bash
+inf training list              # List training runs
+inf training get <id>          # Get details of a training run
+inf training logs <id>         # View training logs (-f to follow)
+inf training poll <id>         # Poll status until complete
+```
+
+### Evals
+
+```bash
+inf eval list                  # List eval run groups
+inf eval get <id>              # Get eval run group details
+inf eval definitions           # List eval definitions
+inf eval datasets              # List eval datasets
+```
+
+### Datasets
+
+```bash
+inf dataset list               # List filtered datasets
+inf dataset get <id>           # Get dataset details
+inf dataset download <id>      # Download a dataset (-o output path)
+```
+
+### Inferences
+
+```bash
+inf inference list             # List recent inferences
+inf inference get <id>         # Get full inference details
+```
+
+### Dashboard
+
+```bash
+inf dashboard                  # Launch interactive TUI dashboard
+```
+
+The dashboard provides a tabbed interface for browsing training runs, evals, datasets, and inferences. Use `1-4` to switch tabs, `j/k` to navigate, `Enter` to drill down, `r` to refresh, and `q` to quit.
+
+## Global Options
+
+| Flag                 | Description                                   |
+| -------------------- | --------------------------------------------- |
+| `--json`             | Output results as JSON (useful for scripting) |
+| `-v, --verbose`      | Enable verbose debug output                   |
+| `-p, --project <id>` | Override the active project for this command  |
+| `--version`          | Show the CLI version                          |
+| `--help`             | Show help                                     |
+
+## Configuration
+
+### Config File
+
+Stored at `~/.inf/config.json`. Managed automatically by `inf auth` commands.
+
+### Environment Variables
+
+| Variable         | Description                   | Default                                   |
+| ---------------- | ----------------------------- | ----------------------------------------- |
+| `INF_API_URL`    | LLM Ops API base URL          | `https://observability-api.inference.net` |
+| `INF_AUTH_URL`   | Auth server base URL          | Derived from API URL                      |
+| `INF_UI_URL`     | Web app URL (for device auth) | Derived from API URL                      |
+| `INF_API_KEY`    | API key for headless/CI auth  |                                           |
+| `INF_PROJECT_ID` | Override active project ID    |                                           |
+
+### Priority Order
+
+Authentication resolves in this order:
+
+1. `INF_API_KEY` environment variable
+2. API key in config file (`inf auth set-key`)
+3. Session token in config file (`inf auth login`)
+
+API URL resolves in this order:
+
+1. `INF_API_URL` environment variable
+2. `apiUrl` in config file
+3. Default: `https://observability-api.inference.net`
+
+## CI / Headless Usage
+
+For CI pipelines and automated environments where browser-based login is not possible:
+
+```bash
+# Set your API key (obtain from Inference.net dashboard under project settings)
+export INF_API_KEY=sk-observability-...
+
+# Or persist it in the config file
+inf auth set-key sk-observability-...
+
+# Set the project
+export INF_PROJECT_ID=your-project-id
+
+# Now all commands work without interactive login
+inf training list --json
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@inference/cli",
+  "version": "0.0.1",
+  "description": "Inference.net CLI - manage training runs, evals, datasets, and inferences from your terminal",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "package.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "inference",
+    "llm",
+    "cli",
+    "training",
+    "eval",
+    "dataset",
+    "machine-learning",
+    "ai"
+  ],
+  "optionalDependencies": {
+    "@inference/cli-darwin-arm64": "0.0.1",
+    "@inference/cli-darwin-x64": "0.0.1",
+    "@inference/cli-linux-x64": "0.0.1",
+    "@inference/cli-linux-arm64": "0.0.1"
+  },
+  "scripts": {
+    "build": "bun run clean:bin && bun run build:cli",
+    "build:cli": "bun build src/index.ts --compile --minify --outfile bin/inf",
+    "build:cli:local": "bun build src/index.ts --compile --outfile bin/inf",
+    "build:npm:darwin-arm64": "bun build src/index.ts --bundle --compile --minify --external '@opentui/core-*' --target=bun-darwin-arm64 --outfile npm/cli-darwin-arm64/bin/inf",
+    "build:npm:darwin-x64": "bun build src/index.ts --bundle --compile --minify --external '@opentui/core-*' --target=bun-darwin-x64 --outfile npm/cli-darwin-x64/bin/inf",
+    "build:npm:linux-x64": "bun build src/index.ts --bundle --compile --minify --external '@opentui/core-*' --target=bun-linux-x64 --outfile npm/cli-linux-x64/bin/inf",
+    "build:npm:linux-arm64": "bun build src/index.ts --bundle --compile --minify --external '@opentui/core-*' --target=bun-linux-arm64 --outfile npm/cli-linux-arm64/bin/inf",
+    "build:npm:all": "bun run clean:npm && bun run build:npm:darwin-arm64 && bun run build:npm:darwin-x64 && bun run build:npm:linux-x64 && bun run build:npm:linux-arm64",
+    "clean:bin": "rm -rf bin/inf",
+    "clean:npm": "rm -f npm/cli-darwin-arm64/bin/inf npm/cli-darwin-x64/bin/inf npm/cli-linux-x64/bin/inf npm/cli-linux-arm64/bin/inf",
+    "dev": "bun src/index.ts",
+    "format": "prettier --check .",
+    "format:fix": "prettier --write .",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "tsc": "tsc"
+  },
+  "dependencies": {
+    "@inference-net/cf-compatible-models": "workspace:*",
+    "@inference-net/llm-ops-trpc-api": "workspace:*",
+    "@opentui/core": "0.1.80",
+    "@opentui/react": "0.1.80",
+    "@trpc/client": "11.4.0",
+    "@trpc/server": "11.4.0",
+    "chalk": "5.4.1",
+    "cli-table3": "0.6.5",
+    "commander": "13.1.0",
+    "open": "10.1.0",
+    "ora": "8.2.0"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.6",
+    "typescript": "5"
+  }
+}