Skip to main content
Welcome to the Hiroshi documentation. Hiroshi is a local-first agentic AI developer assistant built in Rust that runs entirely on your machine using Ollama for inference — no cloud accounts, no data leaving your system. It ships with a multi-agent orchestration loop, polyglot custom skills, MCP server support, cron automation, and optional chat gateways for Telegram, Discord, and Slack.

Introduction

Learn what Hiroshi is, how the agent loop works, and what you can build with it.

Quickstart

Go from a fresh install to your first agent conversation in five minutes.

CLI Reference

Explore every subcommand, flag, and slash command Hiroshi exposes.

Skills

Extend Hiroshi with polyglot scripts in Python, Bash, PowerShell, and more.

Integrations

Connect external tools and services through MCP servers and chat gateways.

Configuration

Understand every field in ~/.hiroshi/config.toml and how to tune them.

​
Get up and running

Follow these four steps to go from zero to a working Hiroshi agent.
1

Install Hiroshi

Build Hiroshi from source using Cargo and optionally add it to your PATH.
git clone https://github.com/hiroshi-os/Hiroshi && cd Hiroshi
cargo build --release
cargo install --path .
2

Run the onboarding wizard

The first time you run any Hiroshi command, an interactive wizard launches automatically and writes ~/.hiroshi/config.toml.
hiroshi agent
The wizard asks for a system name, lets you pick an Ollama model, and optionally configures the Telegram gateway.
3

Start agent mode

Once configuration is complete, Hiroshi drops you into an interactive terminal session where you can chat directly with the active agent.
Hiroshi [Architect] > What should I build today?
4

Optionally launch the daemon

Run hiroshi daemon to start background services: chat gateways (Telegram, Discord, Slack), the web dashboard, the SOP engine, and the cron scheduler — all running concurrently.
hiroshi daemon