hubzoid 2.0.3

One brain for your internal agents.

Build agents around your knowledge and your way of working. Start on your laptop. Bring them to your team.

Documentation · Quickstart · Website · Contribute

Hubzoid turns a folder of your knowledge, rules and tools into an agent you can use yourself and share with your team. Ask it questions in chat, run repeatable workflows, or connect your own assistant through MCP. The rules live in files you can read, edit and version.

Start in two minutes

You need Python 3.11 or 3.12, and Claude Code or Codex signed in on this machine (or a model API key).

python3.12 -m venv .venv
source .venv/bin/activate
pip install hubzoid
hubzoid init my-hub
hubzoid run my-hub

The web app opens at http://127.0.0.1:3080. Ask:

A customer wants a refund 40 days after delivery. What can we offer?

my-hub is a small starter for Kestrel & Oak, a fictional shop. It has every folder Hubzoid reads, three house rules in knowledge/house-rules.md, and a check in evals/. The assistant answers from the rules and names the file.

init uses the Claude Code or Codex you are signed in to. Without one, it offers to save a model API key in the hub's private .env. Subscription limits or provider charges apply. Choose a runtime

Make it yours

1. Open my-hub/knowledge/house-rules.md and change the refund window from 30 days to 45. Or ask Claude Code or Codex to make the change and show you the diff.
2. Stop hubzoid run and start it again.
3. Ask the same question. The answer now follows your rule.

Then replace the sample with your own material: your rules and notes in knowledge/, your job for the assistant in AGENTS.md, your checks in evals/. Only what is in the files is shared. A correction in chat is not saved on its own. Authoring a hub

Help me set up a Hubzoid agent using the quickstart:
https://github.com/hubzoid/hubzoid/blob/main/docs/quickstart.md

Use a new folder and a Python 3.11 or 3.12 virtual environment.
Help me choose an available runtime without pasting secrets into chat.
Run the starter and show me one answer from its house rules.
Then help me turn it into an agent for one task, using material I choose.
Show me each file change before you make it.

Use a ready-to-use hub

Complete agents built on Hubzoid, each in its own repo. Clone one and follow its README.

git clone https://github.com/hubzoid/software-factory-hub software-factory

Each hub's README has a setup prompt for Claude Code or Codex, too.

One hub, three ways to use it

For Claude Code, paste the connection command hubzoid run prints, then open /mcp in Claude Code and approve the connection.

Share with your team

Local mode is private to your machine. To share, turn on sign-in and set the public address in my-hub/.env:

HUBZOID_AUTH=true
HUBZOID_PUBLIC_URL=https://hub.example.com

Then create the first administrator and start the hub:

hubzoid admin create you@example.com my-hub --owner
hubzoid run my-hub

Open the one-time sign-in link it prints, set a password, and add teammates in Settings → People & access. Give each person the agents and capabilities they need. Shared knowledge does not mean shared credentials or access to another person's private results.

For a public deployment, use HTTPS and persistent storage. Team setup · Deployment · Backup and restore

Go further

All guides · Website documentation · Release notes · Upgrading

The chat and its Settings come with pip install hubzoid: no separate UI or Node install. Hubzoid 2 no longer includes Open WebUI. Deployments that need it stay on 1.x (pip install "hubzoid<2"). Python 3.12 workflows need SQLite 3.42 or later, or PostgreSQL. hubzoid doctor my-hub checks this.

Hubzoid is Apache-2.0, including team controls. Dependencies and brand assets keep their own terms. Licensing. To contribute, start with the contributing guide. Need help with your company's agents? Build with us uses the same open-source product.