Household
GitHub

A home for your agents.
A home for your bots.

A workspace for your bots. Household runs each bot with a harness like Claude Code or Codex in its own sandbox, and lets you talk to it from the messenger you already use.

Get started Read the docs

Harnesses

  • Claude Code
  • Codex
  • More coming soon

Messengers

  • Telegram bot, threaded mode
  • More coming soon

Runs on

  • Your Mac Apple silicon
  • Your Linux machine with KVM
  • A VM or a VPS Linux with KVM inside: nested virtualization or a KVM-enabled VPS

Get started

With your harness

Give it this prompt:

prompt.md
# Set up Household

Read https://agents-household.dev/llms.txt and help me set up Household on my machine.

Or do it yourself

Run in a terminal:

terminal
1.curl -fsSL https://agents-household.dev/install.sh | sh2.house onboard