<p align="center">
  <img src="apps/web/public/posthivemain.png" alt="Posthive" width="160" />
</p>

<h1 align="center">Posthive</h1>

<p align="center">
  The agentic social media scheduling platform with built-in AI agent support.<br/>
  Schedule posts across platforms from one place self-hostable, no vendor lock-in.
</p>

<p align="center">
  <a href="https://github.com/AstaBlackClove/posthive/blob/main/LICENSE"><img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" /></a>
  <a href="https://github.com/AstaBlackClove/posthive"><img alt="GitHub Repo" src="https://img.shields.io/github/stars/AstaBlackClove/posthive?style=social" /></a>
  <a href="https://discord.gg/UEdnAtHxgN"><img alt="Discord" src="https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white" /></a>
</p>

<p align="center">
  <a href="https://posthive.co/docs"><b>📖 Docs</b></a> ·
  <a href="https://posthive.co/agent"><b>🤖 AI Agent Setup</b></a> ·
  <a href="https://discord.gg/UEdnAtHxgN"><b>💬 Discord</b></a> ·
  <a href="https://posthive.co"><b>🌐 Website</b></a>
</p>

<br/>

<p align="center">
  <img src="https://img.shields.io/badge/Bluesky-0285FF?logo=bluesky&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Threads-000000?logo=threads&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Instagram-E4405F?logo=instagram&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Facebook-1877F2?logo=facebook&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/TikTok-000000?logo=tiktok&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/YouTube-FF0000?logo=youtube&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/LinkedIn-0A66C2?logo=linkedin&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Mastodon-6364FF?logo=mastodon&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Pinterest-E60023?logo=pinterest&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/X%2FTwitter-000000?logo=x&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Telegram-26A5E4?logo=telegram&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Tumblr-35465C?logo=tumblr&logoColor=white&style=flat" />
  <img src="https://img.shields.io/badge/Nostr-8B5CF6?style=flat" />
  <img src="https://img.shields.io/badge/Lemmy-FF4500?style=flat" />
</p>

<br/>

<p align="center">
  <img src="apps/web/public/posthiveconver.png" alt="Posthive dashboard" width="100%" />
</p>

---

## Features

- **Multi-platform posting** - write once, publish to 14+ platforms simultaneously
- **AI agent support** - connect Claude, ChatGPT, Cursor, VS Code via MCP; OAuth 2.0 + PKCE, no API key to paste
- **Calendar view** - FullCalendar month/week/day with drag-to-reschedule
- **Bulk CSV scheduling** - upload a spreadsheet to schedule hundreds of posts at once
- **Post templates** - save and reuse post drafts
- **First comment scheduling** - auto-reply immediately after the post goes live
- **Per-platform overrides** - custom text and first comment per account
- **Instagram Reels & Stories** - full media type support including carousels
- **YouTube Shorts & videos** - dedicated title/description fields, custom thumbnail upload
- **Dry run mode** - test the full pipeline without real API calls
- **Draft posts** - save compose state, schedule later
- **Public REST API** - full CRUD with Bearer auth (Pro/Team)
- **Self-hostable** - Docker compose, one command, billing optional

---

## Tech Stack

| Layer | Technology |
|-------|-----------|
| Frontend | Next.js 16 (App Router), React 18, Tailwind CSS |
| Backend | Fastify v4, TypeScript ESM, Node.js |
| Database | Prisma 5 (SQLite for dev, Postgres for prod) |
| Queue | BullMQ + Redis (Upstash / Railway) |
| Storage | Local disk (dev) / Supabase Storage (prod) |
| Email | Resend |
| Billing | Dodo Payments (optional) |
| Monitoring | Sentry |

---

## Quick Start (Self-hosting)

```bash
git clone https://github.com/AstaBlackClove/posthive.git
cd posthive
cp apps/api/.env.example .env
# Fill in ENCRYPTION_KEY, JWT secrets, DATABASE_URL, REDIS_URL
docker compose up -d --build
```

Open `http://localhost:3000` and register. Billing is disabled by default all features unlocked.

**Full setup guide →** [posthive.co/docs](https://posthive.co/docs)

---

## Developer Setup

```bash
pnpm install
cp apps/api/.env.example apps/api/.env
pnpm dev        # starts API + Web + Postgres (Docker)
```

| Service | URL |
|---------|-----|
| Web | http://localhost:3000 |
| API | http://localhost:3001 |
| Prisma Studio | http://localhost:5555 |

**Environment variables & platform OAuth setup →** [posthive.co/docs](https://posthive.co/docs)

---

## AI Agent Integration (MCP)

Connect any MCP-compatible AI agent to Posthive with a single URL no API key to generate or paste.

```bash
# Claude Code
claude mcp add --transport http posthive https://your-api/mcp

# Cursor / VS Code — add to mcp.json
{ "mcpServers": { "posthive": { "url": "https://your-api/mcp" } } }
```

The first tool call opens your browser to sign in. **Full setup per client →** [posthive.co/agent](https://posthive.co/agent)

**10 tools available:** `list_accounts` · `create_post` · `get_post` · `list_scheduled_posts` · `approve_draft` · `update_post` · `duplicate_post` · `delete_post` · `list_templates` · `create_from_template`

---

## Star History

[![Star History Chart](https://api.star-history.com/chart?repos=AstaBlackClove/posthive&type=date&legend=top-left&sealed_token=KArWljHVyC2uW1jZFEunk4hv9bQ6icDOFz1x4HxgyVURXuZY2PSrZEnOC-K4NyWFfxGsg8ePO8iPWNVokmpSm4aRwpz8EfE0HFYBDFppW332zLCdigr_ncrGyafPyaaquoxZ7i7XWz16ZdEHsjpKQGzBUMAWMzMMW018efpnyGNI6L2Q14093OoiXRN3)](https://www.star-history.com/?repos=AstaBlackClove%2Fposthive&type=date&legend=top-left)

---

## Community

Questions, feature requests, bugs join the Discord:

**[discord.gg/UEdnAtHxgN](https://discord.gg/UEdnAtHxgN)**

---

---

## License

[AGPL-3.0](LICENSE) if you modify this project and run it as a network service, you must make your source available to users of that service.