@xynqai/cli
v0.3.0
Published
XYNQ command-line client — chat with XYNQ over the decentralized GPU network from your terminal.
Maintainers
Readme
@xynqai/cli
Chat with XYNQ from your terminal. Your messages run on the decentralized XYNQ network — the coordinator dispatches each request to a connected GPU worker and streams the response back.
Install
npm i -g @xynqai/cliUse
xynq
# then: /login → paste xynq_sk_... → start chattingGet your API key at xynq.ai → Account (sign in, then
create a key). Every account includes 1,000,000 free tokens per month; beyond
that, usage is billed from your prepaid USDC credit balance. Once you've run
/login, just type a message and the reply streams back live.
Commands
| Command | What it does |
| --- | --- |
| /login [key] | Save your XYNQ API key (xynq_sk_...) |
| /logout | Remove the saved key |
| /model <id> | Switch model (default jaguar) |
| /models | List available models |
| /nodes | Show GPU workers currently online |
| /clear | Clear conversation history |
| /help | Show help |
| /exit | Quit |
Your key is stored locally in ~/.xynq/config.json.
Models
| id | Notes |
| --- | --- |
| jaguar | Default. Fast 8B-class model. |
| qwen-3.5-27b | Larger, multilingual. |
| supergemma-4-26b | 27B-class quality. |
Availability depends on which workers are online. Run
/nodesto see what's currently serving. If you get "no GPU worker is online for this model", tryjaguaror check back shortly.
Configuration
| Env var / flag | Purpose | Default |
| --- | --- | --- |
| --model <id> | Start with a specific model | jaguar |
| --orch <url> / XYNQ_ORCH | Point at a different coordinator | XYNQ mainnet coordinator |
| XYNQ_API_KEY | Use a key without /login (CI, scripts) | from /login |
One-off (no install)
npx @xynqai/cliTroubleshooting
EACCES: permission denied on npm i -g (macOS/Linux): your Node lives in a
system directory, so global installs need elevated permissions. Easiest fix is to
skip the global install and run npx @xynqai/cli. To install globally without
sudo, point npm at a user-writable prefix:
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
npm i -g @xynqai/cli