CLI

Requirements

• Node.js >= 24, or
• Bun >= 1.1

Either runtime works everywhere below — pick whichever you already have installed.

Run without installing

The fastest way to try Hooman:

npx hoomanjs

Or with Bun:

bunx hoomanjs

Both download hoomanjs on first use and cache it for next time — no separate install step, and nothing left behind if you don’t keep using it.

Install globally

If you’ll be reaching for hooman often, install it once and run it directly:

npm i -g hoomanjs

bun add -g hoomanjs

hooman

First run

1. Start chatting with hooman (equivalent to hooman chat).
2. Run /config inside the chat to pick your LLM provider and model, and to manage MCP servers and skills.
3. Use hooman exec "your prompt" for one-off tasks once you’re set up.

By default Hooman runs Qwen3 1.7B locally via llama.cpp, with Qwen3.5 0.8B and Gemma 4 E2B preconfigured alongside it, so it works out of the box without any API keys — the default model (~1.8 GB) downloads from the Hugging Face Hub on first use, with a live progress bar (percent, size, speed, ETA) in the chat. Swap in a hosted provider whenever you’re ready. See Models for the full list and configuration shape.

Run from source

Prefer to build from the repository instead of the published package:

git clone https://github.com/vaibhavpandeyvpz/hooman.git
cd hooman
npm install
npm run dev -- --help

Or build and link the CLI locally:

npm run build
npm link
hooman --help

Next steps

• CLI reference — every command, flag, and in-chat slash command.
• Configuration — ~/.hooman layout and repo-local overlays.
• Models — connect Anthropic, OpenAI, Google, Ollama, and more.
• VS Code quickstart — prefer a chat panel in your editor instead?