@infer-platform/cli

CLI wrapper for Infer Platform binaries. Automatically downloads and manages the node-agent binary for your platform.

Installation

npm install -g @infer-platform/cli

Or use directly with npx:

npx @infer-platform/cli --help

Usage

Basic Commands

# Show CLI version
infer --version

# Show help
infer --help

Node Agent Management

# Install/reinstall the node-agent binary
infer node-agent install

# Show path to installed binary
infer node-agent path

# Run node-agent with arguments
infer node-agent --help
infer node-agent --version

Running Node Agent

The CLI automatically proxies commands to the installed node-agent binary:

# Start node agent
infer node-agent

# With custom configuration
NODE_MODEL=llama3.1:8b \
NODE_PORT=8081 \
COORDINATOR_URL=https://api.infer-platform.com \
infer node-agent

Environment Variables

Download Configuration

• INFER_BINARY_MIRROR - Custom URL for binary downloads (default: GitHub releases)
• INFER_NODE_AGENT_CHECKSUM_URL - Override SHA256 checksum URL (default: ${binaryUrl}.sha256)
• INFER_SKIP_CHECKSUM - Set to true to skip SHA256 verification for local development/private mirrors
• INFER_SKIP_BINARY_DOWNLOAD - Set to true to skip automatic download during install
• INFER_FORCE_REINSTALL - Set to true to force reinstall even if binary exists

Runtime Configuration

• INFER_BINARY_PATH - Custom path to node-agent binary (overrides auto-detected path)

Supported Platforms

• Linux: x64, arm64
• macOS: x64 (Intel), arm64 (Apple Silicon)
• Windows: x64

How It Works

1. During npm install, the CLI downloads the appropriate node-agent binary for your platform
2. By default, it also downloads ${binaryUrl}.sha256 and verifies the binary with SHA256
3. Binary is stored in .infer-bin/ directory within the package
4. When you run infer node-agent, it executes the downloaded binary
5. If download or checksum verification fails during install, you can manually download and place the binary in the expected location

Development

# Clone the repository
git clone https://github.com/infer-platform/infer.git
cd infer/packages/infer-cli

# Install dependencies (none required - zero dependencies!)
npm install

# Run tests
npm test

# Test CLI locally
node bin/infer.js --help

Testing

The CLI includes comprehensive tests that don't require internet access:

npm test

Tests cover:

• Platform detection
• Binary download (with mock HTTP server)
• Checksum verification
• CLI commands and argument passing

Troubleshooting

Binary download fails

If the automatic download fails during install:

1. Check your internet connection
2. Try setting a custom mirror: export INFER_BINARY_MIRROR=https://your-mirror.com
3. Manually download the binary from releases
4. Place it in: node_modules/@infer-platform/cli/.infer-bin/node-agent
5. Make it executable: chmod +x node_modules/@infer-platform/cli/.infer-bin/node-agent

Command not found

After global install, if infer is not found:

1. Check npm global bin directory: npm bin -g
2. Ensure it's in your PATH
3. Or use npx @infer-platform/cli instead

License

MIT - See LICENSE file for details

Related

• Infer Platform - Main repository
• Documentation - Full platform documentation