Mithra

Mithra is a family operating system for busy couples. It brings finance, health records, household plans, and upcoming obligations into one calm household view, while each adult can keep selected records Only you.

The app turns text, voice, CSV, XLSX, and PDF inputs into reviewable, evidence-linked records. It never changes a record without confirmation, spends money, makes bookings, gives medical or financial advice, judges either partner, or mediates a relationship.

Week in Review

Week in Review turns valid shared records into a short weekly plan:

• A deterministic status: On track, Mostly on track, or Needs attention.
• No more than three ranked priorities, with the reason, date, status, and a grounded next step.
• A factual observation from recorded totals, budgets, and trends.
• Recent progress and a compact upcoming timeline.
• A separate Only you area for each adult's private records and data-quality notices.

Mithra groups a planning item and a finance obligation only when their titles, dates, and privacy scope strongly match. It does not expose a private record, or even the existence of a private issue, in shared status or copy. Invalid or incompatible health readings never support a comparison or coaching claim.

Try the hosted app at app.mithrahq.com. It is invitation-only; there is no public signup.

Start here

• User guide — capture, imports, Shared, Only you, Family Brief, Week in Review, and model-provider boundaries.
• Product tour — the main household views.
• Self-hosting — verified install and the operator lifecycle.
• Deploy with containers / Dokploy — the compose stack, its settings, volumes, encryption at rest and admin commands.
• Architecture, security, operations, and backup and restore — implementation and recovery contracts.

Run locally

Copy .env.example to .env, replace its placeholders with absolute paths to service-user-owned 0600 credential files, and keep the base64url-encoded 32-byte master key apart. Mithra does not read .env itself:

set -a
source .env
set +a
GOFLAGS=-tags=sqlite_fts5,sqlite_omit_load_extension \
GOCACHE=/private/tmp/mithra-build-cache \
go run ./cmd/mithra

Open http://127.0.0.1:8090; readiness is /healthz. The owner email (MITHRA_OWNER_EMAIL) uses Set or reset your password on first visit, then invites a partner from Settings.

Synthetic demo household

An operator can reset the marked synthetic household and set two demo passwords without publishing them. Each password file must be a private regular file owned by root, and contain a 12–128 byte password.

sudo mithra-installer reset-demo \
  --owner-email [email protected] \
  --partner-email [email protected] \
  --owner-password-file /root/mithra-demo-owner.password \
  --partner-password-file /root/mithra-demo-partner.password

The reset command works only on the marked demo household. It takes a verified encrypted backup, restores the fixture through normal product services, revokes old demo sessions and reset links, then starts the service again. It cannot change an ordinary household. Share the chosen credentials privately; do not commit them.

Verify

GOFLAGS=-tags=sqlite_fts5,sqlite_omit_load_extension \
GOCACHE=/private/tmp/mithra-build-cache \
go test -count=1 ./...

node --check web/static/app.js
node --test web/static/*.test.mjs