Install hob

Install the hob binary on macOS, Linux, or Windows, connect a model provider, and start hob in your project.

hob is one binary. Install it with the method that you already use.

Install

With the install script, on macOS, Linux, or Git Bash on Windows:

Terminal
curl -fsSL https://hobcode.com/install.sh | sh

With PowerShell, on Windows:

powershell
irm https://hobcode.com/install.ps1 | iex

With Homebrew:

Terminal
brew install hob

With Nix, with no install step:

Terminal
nix run github:inteist/hob

From the main branch, with Cargo:

Terminal
cargo install --locked --git https://github.com/inteist/hob.git hob

The scripts install hob to ~/.local/bin, or to %LOCALAPPDATA%\hob on Windows, and add it to your user PATH on Windows. To use a different folder, set HOB_INSTALL_DIR ($env:HOB_INSTALL_DIR in PowerShell).

Read a script before you run it. Download it first, then run it:

Terminal
curl -fsSL https://hobcode.com/install.sh -o install.sh

You can also download a prebuilt binary from the GitHub releases.

Connect a model

hob does not include a model. Set the API key of a provider, such as ANTHROPIC_API_KEY, OPENAI_API_KEY, or GEMINI_API_KEY. hob also connects to local models through Ollama and llama.cpp.

For OpenAI, xAI, and GitHub Copilot, you can sign in instead:

Terminal
hob auth login openai

Start hob

Run hob in your project:

Terminal
hob

The config is a Lua file, ~/.config/hob/init.lua. To see every option, with notes, print the example config:

Terminal
hob config example | less

hob update installs the newest release. hob rollback goes back to the release before it.

Next: your first session.

Keyboard shortcuts

Go to

On this page

  • jkNext or previous section
  • 12…The section with that number
  • cCopy the install command
  • iDownload
  • dDocs
  • []Previous or next page

Anywhere

  • ?Show or hide this list
  • EscClose, or stop a "g"