# Social

URL: https://docs.hanzo.ai/docs/projects/hanzoai/social

> 📨 Hanzo Social — agentic social media scheduling 🤖

![social](https://docs.hanzo.ai/docs/projects/hanzoai/.github/hero.svg)

[![Hanzo Social](https://hanzo.ai/logo-mark.svg)](https://social.hanzo.ai)

[![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://opensource.org/license/agpl-v3)

Hanzo Social

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

[social.hanzo.ai](https://social.hanzo.ai)
·
[hanzo.ai](https://hanzo.ai)
·
[hanzo.id (SSO)](https://hanzo.id)

---

## What this is

Hanzo Social is a hard fork of [`gitroomhq/postiz-app`](https://github.com/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

```bash
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`.

## Links

- [Source](https://github.com/hanzoai/social)
- [Project site](https://social.hanzo.ai)
- Licence: AGPL-3.0