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:
curl -fsSL https://hobcode.com/install.sh | shWith PowerShell, on Windows:
irm https://hobcode.com/install.ps1 | iexWith Homebrew:
brew install hobWith Nix, with no install step:
nix run github:inteist/hobFrom the main branch, with Cargo:
cargo install --locked --git https://github.com/inteist/hob.git hobThe 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:
curl -fsSL https://hobcode.com/install.sh -o install.shYou 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:
hob auth login openaiStart hob
Run hob in your project:
hobThe config is a Lua file, ~/.config/hob/init.lua. To see every option, with notes, print the example config:
hob config example | lesshob update installs the newest release. hob rollback goes back to the release before it.
Next: your first session.