social/README.md

Hanzo Social

Agentic social media scheduling for the Hanzo platform — schedule, publish, and analyze across 28+ channels.

social.hanzo.ai · hanzo.ai · hanzo.id (SSO)

---

What this is

Hanzo Social is a hard fork of gitroomhq/postiz-app (AGPL-3.0), rebranded and integrated with the Hanzo platform:

• Auth — Hanzo IAM (hanzo.id) via OIDC (IAM_CLIENT_ID=hanzo-social).
• Storage — Hanzo S3 (s3-api.hanzo.ai).
• Secrets — Hanzo KMS (kms.hanzo.ai) via kms-fetch init container.
• Email — social@hanzo.ai from the shared SMTP relay.
• Bot — ~/work/hanzo/bot exposes /social {schedule|draft|integrations} against this backend.

Upstream remains the source of truth for the scheduling engine; brand and platform glue live in this repo.

Develop

pnpm install
pnpm dev

See CLAUDE.md for repo layout and apps/, libraries/ for the NestJS backend / Vite frontend / Temporal worker.

License

AGPL-3.0 — same as upstream. See LICENSE.