README
¶
cLLMHub CLI
The command-line interface for cLLMHub — turn your local LLM into a production API.
What it does
- Login to your cLLMHub account via OAuth device flow
- Publish models from your machine to the hub so anyone with an API key can use them
- Whoami to see the currently logged-in user
- Logout to revoke credentials
- Update the CLI to the latest version
Quick start
# Install
curl -fsSL https://raw.githubusercontent.com/cllmhub/cllmhub-cli/main/install.sh | sh
# Authenticate
cllmhub login
# Publish a model (interactive — picks from local backends)
cllmhub publish
# Or specify the model directly
cllmhub publish -m llama3 -b ollama
Installation
Pre-built binaries
Download from your hub's Settings > Downloads page. Available for:
| Platform | Architecture |
|---|---|
| macOS | Apple Silicon (arm64), Intel (amd64) |
| Linux | x86_64 (amd64), ARM64 |
| Windows | x86_64 (amd64) |
Build from source
Requires Go 1.22+.
git clone https://github.com/cllmhub/cllmhub-cli.git
cd cllmhub-cli
make build
# Binary is at bin/cllmhub
Cross-compile for all platforms:
make build-all
Commands
cllmhub login
Authenticate with cLLMHub using OAuth 2.0 device flow. Opens a browser to complete authorization.
Flags:
--hub-url Hub gateway URL (default: https://cllmhub.com)
The hub URL is saved after login so all subsequent commands use it automatically.
cllmhub whoami
Show the currently logged-in user.
cllmhub publish
Publish a local model to the hub. Keeps a persistent connection — your model is online as long as the CLI is running.
When run without -m, it discovers models from local backends and lets you pick one interactively.
Flags:
--model, -m Model name to publish (omit for interactive selection)
--backend, -b Backend type: ollama | vllm | llamacpp | custom (default: ollama)
--backend-url Backend endpoint URL (overrides default for the backend type)
--hub-url Hub gateway URL (default: saved from login, or https://cllmhub.com)
cllmhub logout
Revoke credentials on the server and remove the local credentials file.
cllmhub update
Update the CLI to the latest version.
Supported backends
| Backend | Default endpoint | Notes |
|---|---|---|
ollama |
http://localhost:11434 | Default backend, most common |
vllm |
http://localhost:8000 | High throughput, GPU optimized |
llamacpp |
http://localhost:8080 | CPU-friendly, quantized models |
custom |
(user-specified) | Any OpenAI-compatible HTTP server |
License
Apache License 2.0 — see LICENSE.
Directories