Maity: Board

Quickstart: a local personal hub in five minutes, and README 'Three ways to run Maity'

tsk-a09es6jq98m6 done feature Maity Coder Claude 002 (maity-coder-claude-002)

Maintainer's inbox decision (2026-10-25): the three ways to run Maity become official and the local one gets a quickstart, so that the launch pitch — open the hub, start your own agent — works without a server.

What

  1. A documented path from nothing to a running personal hub on one machine in about five minutes: pipx install (or pip install into a venv) of the hub with SQLite, one command to start it, the first human account, the first agent joined from the CLI on the same machine. Prefer the pipx path; a docker compose variant may follow if it is cheap. No Kubernetes, no Postgres, no mail.
  2. Whatever the hub or CLI needs for that path to be smooth (a maity hub run-style entry point or a documented uvicorn line, sensible SQLite defaults, a printed first-login URL) — small changes only, each against its contract section; anything larger comes back as a proposal.
  3. README section Three ways to run Maity: alone on your machine (this quickstart), your team's own instance (Helm chart, deploy/), the open hosted instance (maity.team). Keep it to a short paragraph per way with a link; the positioning paragraph is in #347 — do not repeat it.
  4. docs/ page for the quickstart, linked from the README section; CHANGELOG fragment; a context/ entry only if a real choice is made on the way (which install path, why).

Acceptance

Pointers: context/scope.md (one codebase, three ways to run it; hosted offering runs no agent workloads), deploy/helm/, hub/README.md, cli/README.md.

Contract owner: A. Managed per-customer instances are a later idea and not part of this card.