Postmill AI
Open-source, AI-native social media management, design and scheduling.
Postmill is a self-hostable social media scheduler for agencies and multi-brand teams: a visual publishing calendar, 45+ channels, 46 built-in media tools, and bring-your-own-key AI across 31 providers. Run it on infrastructure you control, and let every organization manage its own channels, brands, and AI keys. An open-source alternative to Buffer, Hootsuite, and Sprout Social.
Website · Docs · Quick Start · Node SDK (@postmill-ai/postmill-sdk) · Public API
📸 Screenshots
Postmill brings design, publishing, analytics, and engagement into one workspace. Click any screenshot for the full-size view.
That's the 30-second tour — the full feature tour, with every screen, lives in the documentation.
🚀 Quick Start
git clone https://github.com/postmill-ai/postmill-app.git
cd postmill-app
pnpm install
cp .env.example .env # then fill in your values
docker compose -f docker/docker-compose.dev.yaml up -d # postgres + redis
pnpm run dev:minimal # backend + frontend
The frontend runs on port 4200. That's the development stack; for production, use the published Docker image with the root docker-compose.yaml:
docker pull postmillai/postmill-app # Docker Hub
docker pull ghcr.io/postmill-ai/postmill-app # GitHub Container Registry (same image)
Full setup, configuration reference, and deployment guide: documentation.
🔌 Channel setup
Channels connect through OAuth apps registered with each platform. To offer one-click connections on your installation, configure platform channel apps for the providers you want to support: register an app in the provider's developer portal, add the issued credentials to .env, and test with an authorized account. Some providers require app review before broader access and may ask for app details, screenshots, or a demo video.
Organizations can also connect channels with their own app keys, and direct-auth channels (API tokens, self-hosted instances) need no platform app at all. On Postmill's hosted service, platform apps are already configured, so one-click OAuth is available by default for supported channels.
🎬 The Designer — a full image & video editor, built in
A production-grade, layered editor inside your publishing workspace — no round-trips through Canva, Photoshop, or CapCut. People at home in professional design tools should feel at home here; people who aren't can start from a template or let the AI Designer drive.
- Image mode — a Photoshop-style layered canvas: rich text, shapes, pen and path tools, brushes, gradients, marquee/lasso/object selections, crop, clone stamp, blend modes, and brand-kit colors and fonts surfaced while you work.
- Video mode — a multi-track timeline (video, image, text, audio, captions) with trimming, splitting, transitions, keyframed motion (custom or one-click Ken Burns), speed ramps, reverse, freeze frames, filters and cinematic looks, fades, and volume envelopes — up to three minutes at 30 fps.
- AI generation without leaving the canvas — generate images, video, music, voiceovers, and avatar clips from inside the editor. Each prompt dialog uses your organization's default model, or drops down to any configured provider — Replicate, OpenAI, OpenRouter, HeyGen, Runway, and more — with that provider's own settings embedded. Results land directly on the canvas or timeline.
- AI edit tools — remove backgrounds, upscale, inpaint, expand images, auto-detect subjects, and replace images in place.
- Multi-format by design — one editable file holds every channel variant (square post, portrait reel, story, and more), each with its own aspect ratio and layout. Export any variant to the media library, or attach the whole set to a multi-channel scheduled post.
- Templates — save any design as a reusable, on-brand template for the team.
Prefer to describe the design than draw it? The AI Designer drives the same production workflow through a conversational creative agent — see 46 built-in media tools.
📅 Visual publishing calendar
Month, week, and day views of scheduled, published, draft, and failed posts across every channel. Filter by channel, open a post to review its content and performance, or drag it within the week view to reschedule. Times follow each user's timezone.
📢 45+ channels, one composer
Schedule and publish across 45+ social, chat, blogging, and email channels from a single composer. Native support for polls, first-comment automation, threads, per-channel settings, and channel-aware previews means each platform gets exactly what it expects — from a single write. Attach media from your library or create it in-app, pick a brand per post, and toggle link shortening per post with your organization's own short-link provider.
🌐 Supported channels
X · LinkedIn · LinkedIn Page · Reddit · Instagram Business · Instagram Standalone · Facebook Page · Threads · YouTube · Google My Business · TikTok · Pinterest · Dribbble · Discord · Slack · Kick · Twitch · Mastodon · Bluesky · Lemmy · Farcaster · Telegram · LINE · Matrix · Nostr · VK · Medium · Dev.to · Hashnode · WordPress · ListMonk · Moltbook · Whop · Skool · MeWe · Tumblr · Pixelfed · PeerTube · Akkoma · Discourse · Friendica · GoToSocial · Misskey · Odysee · Sharkey
Per-channel VPN routing is available for outbound publishing — each channel can optionally egress through its own configured VPN region.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
