{"_id":"@alveare-ai/cli","name":"@alveare-ai/cli","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@alveare-ai/cli","version":"0.1.0","description":"CLI tool for the Alveare Private SLM Inference-as-a-Service platform","type":"module","bin":{"alveare":"dist/bin/oraculum.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/bin/oraculum.js","clean":"rm -rf dist","prepublishOnly":"npm run build"},"keywords":["alveare","slm","inference","cli"],"license":"MIT","engines":{"node":">=18.0.0"},"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_id":"@alveare-ai/cli@0.1.0","gitHead":"6747d650207af2f46dc73d98f7dfa6b443b9901e","_nodeVersion":"20.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-mxZAOo+I0xG+ZIRbQvZIfwFLkioukhotnCdBNuB3krdjhfh6R013RDX0E/7Mgswkymyu/uTnu5TDYxkBg6ierQ==","shasum":"908451758698c14f0a2232295af4b74dbc94fd66","tarball":"https://registry.npmjs.org/@alveare-ai/cli/-/cli-0.1.0.tgz","fileCount":38,"unpackedSize":83354,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICepOdFK920Vvx5ZAkJWDC46VtLyN5yr+ii8OI/NCtj6AiEA5AJR6I+JCx64kjSM4h9R9g7fw6baIq4SlC3FxNWrYso="}]},"_npmUser":{"name":"alveare","email":"npm@alveare.ai"},"directories":{},"maintainers":[{"name":"alveare","email":"npm@alveare.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.1.0_1773735327249_0.4543256703964853"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T08:15:27.152Z","0.1.0":"2026-03-17T08:15:27.419Z","modified":"2026-03-17T08:15:27.678Z"},"maintainers":[{"name":"alveare","email":"npm@alveare.ai"}],"description":"CLI tool for the Alveare Private SLM Inference-as-a-Service platform","keywords":["alveare","slm","inference","cli"],"license":"MIT","readme":"# @alveare/cli\n\nCommand-line interface for the Alveare Private SLM Inference-as-a-Service platform.\n\n## Installation\n\n```bash\nnpm install -g @alveare/cli\n```\n\nOr link locally for development:\n\n```bash\ncd cli\nnpm install\nnpm run build\nnpm link\n```\n\n## Quick Start\n\n```bash\n# Configure your API key\nalveare config set api-key alv_live_<your-key-here>\n\n# Run inference\nalveare infer -s summarise \"Summarise this quarterly earnings report...\"\n\n# Interactive chat\nalveare chat\n\n# Check available specialists\nalveare models\n\n# View usage stats\nalveare usage\n```\n\n## Commands\n\n### `alveare config`\n\nManage CLI configuration stored at `~/.alveare/config.json`.\n\n```bash\nalveare config set api-key alv_live_abc123def456...\nalveare config set base-url https://api.alveare.ai\nalveare config show\n```\n\n### `alveare infer`\n\nRun a single inference request.\n\n```bash\nalveare infer -s summarise \"Your text here...\"\nalveare infer -s classify -m 32 \"Is this spam?\"\nalveare infer -s code \"Write a prime checker in Python\"\n\n# Pipe from stdin\ncat report.txt | alveare infer -s extract --max-tokens 1024\necho \"Classify this\" | alveare infer -s classify\n```\n\n**Options:**\n- `-s, --specialist <name>` — Specialist to use (required)\n- `-m, --max-tokens <n>` — Maximum tokens in response (default: 256)\n- `--json` — Output raw JSON response\n\n### `alveare chat`\n\nStart an interactive chat session.\n\n```bash\nalveare chat                  # default: chat specialist\nalveare chat -s qa            # use a specific specialist\nalveare chat -s code -m 1024  # with custom max tokens\n```\n\n**In-session commands:**\n- `/quit` or `/exit` — End the session\n- `/clear` — Clear conversation history\n- `/specialist <name>` — Switch specialist mid-conversation\n\n### `alveare models`\n\nList available specialists/models.\n\n```bash\nalveare models\nalveare models --json\n```\n\n### `alveare usage`\n\nShow usage statistics for the current billing period.\n\n```bash\nalveare usage\nalveare usage --json\n```\n\n### `alveare health`\n\nCheck the API health status.\n\n```bash\nalveare health\nalveare health --json\n```\n\n## Configuration\n\nThe CLI resolves configuration in this order (highest priority first):\n\n1. Command-line flags (`--api-key`, `--base-url`)\n2. Environment variables (`ALVEARE_API_KEY`, `ALVEARE_BASE_URL`)\n3. Config file (`~/.alveare/config.json`)\n\n### Environment Variables\n\n| Variable | Description |\n|---|---|\n| `ALVEARE_API_KEY` | API key |\n| `ALVEARE_BASE_URL` | API base URL |\n| `NO_COLOR` | Disable colored output |\n\n## API Key Format\n\nAlveare API keys follow the format:\n- **Live:** `alv_live_<32-hex-chars>`\n- **Test:** `alv_test_<32-hex-chars>`\n\n## Specialists\n\n| Specialist | Description |\n|---|---|\n| `classify` | Text classification |\n| `summarise` | Text summarisation |\n| `extract` | Information extraction |\n| `qa` | Question answering |\n| `chat` | General conversation |\n| `code` | Code generation and assistance |\n| `custom` | Custom specialist |\n\n## Requirements\n\n- Node.js >= 18.0.0 (uses native `fetch`)\n- No runtime dependencies\n","readmeFilename":"README.md","_rev":"1-13938606c81bb1acd389d73a45ba5240"}