Run Your Social Media from Hermes Agent

Postiz plugs into Hermes Agent, the open-source autonomous AI agent by Nous Research. Add it as a skill and Hermes can schedule, publish, and manage your posts across 30+ platforms — autonomously, from any chat app, or on a schedule.

View Docs

Start for $0

Please make sure there is always a human in the loop.

Add the Postiz Skill to Hermes Agent

Install Hermes Agent, then add the Postiz skill. Two commands and you're ready to post.

1. Install Hermes Agent

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

2. Add the Postiz skill

npx skills add gitroomhq/postiz-agent

Then set your API key & go

# Finish Hermes setup
hermes setup

# Set your API key (from Postiz settings)
export POSTIZ_API_KEY=your_api_key

# Now just ask Hermes to post for you

Built for Automation

🤖

AI Agent Ready

Every command outputs structured JSON. Designed for LLMs and automation pipelines to parse, plan, and execute social media workflows.

🌐

30+ Platforms

Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms from a single skill.

🧵

Threads & Comments

Create threaded posts with multiple comments, each with their own media. Automatic conversion to platform-native threads.

📷

Rich Media Support

Upload and attach images, videos, audio, and documents. Supports PNG, JPG, MP4, MOV, PDF, and many more formats.

📅

Scheduled Posting

Schedule posts with precise timestamps, create drafts for review, and batch schedule entire content campaigns.

⚙️

Platform-Specific Settings

Dynamic discovery of platform features like Reddit flairs, YouTube playlists, Pinterest boards, and LinkedIn company pages.

What is Hermes Agent?

Hermes Agent is the open-source autonomous AI agent by Nous Research. It runs on your own server, remembers what it learns through persistent memory and auto-generated skills, and takes real actions on your behalf — including managing your social media with Postiz.

💬

Message From Anywhere

Talk to Hermes from Telegram, Discord, Slack, WhatsApp, Signal, Email, or the CLI. No new app to learn — just message it.

🧠

Persistent Memory & Skills

Hermes remembers what it learns and auto-generates skills, getting more capable the longer it runs. Postiz becomes one of those skills.

⏰

Natural-Language Scheduling

Ask Hermes to post on a schedule in plain English. It runs reports, briefings, and recurring posts without you lifting a finger.

How Postiz Becomes a Hermes Skill

When you install Postiz Agent, Hermes discovers it by reading the bundled SKILL.md file. This file tells Hermes what commands are available, what environment variables are needed, and how to compose posts with the right settings for each platform.

✓Add the skill with one command: npx skills add gitroomhq/postiz-agent
✓Hermes reads the SKILL.md and learns all Postiz commands
✓Eligibility is checked automatically — POSTIZ_API_KEY must be set
✓Skills are loaded on-demand, keeping the agent context clean
✓Runs sandboxed (local, Docker, SSH, Singularity, or Modal)

Add the Postiz skill

# Install Hermes Agent
curl -fsSL \
  https://hermes-agent.nousresearch.com/install.sh \
  | bash
hermes setup

# Add the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Output:
# - postiz: Social media automation
#   CLI for scheduling posts
#   across 30+ platforms

Post From Any Chat App

Message Hermes from Telegram, Discord, Slack, WhatsApp, or Signal — it reads the Postiz skill, discovers your integrations, and handles the entire posting workflow autonomously.

From Any Chat App

Telegram, Discord, Slack, WhatsApp, Signal...

Send a message to Hermes from your favorite chat app. It runs autonomously on your server, so it picks up your message, discovers your accounts via Postiz, uploads media, and schedules posts — all while you go about your day.

Telegram / Discord

You: Post my blog article to Twitter,
  LinkedIn, and Reddit with the cover
  image, schedule for tomorrow at 9am

Hermes: Done! Posts scheduled:
  - X (Twitter): scheduled 9:00 AM
  - LinkedIn: scheduled 9:00 AM
  - Reddit (r/programming): scheduled 9:00 AM
  Post ID: abc-123

Scheduled & Proactive

Natural-language recurring tasks

Hermes supports natural-language scheduling. Set up a recurring task that checks for new content and posts it to all your platforms automatically — no manual trigger needed.

Scheduled task

Tell Hermes:

"Every weekday at 9am, check my
~/content/pending folder for new posts.
Upload any media, then schedule them to
Twitter, LinkedIn, and Instagram for
noon today. Move posted files to
~/content/done."

Hermes runs it on schedule, autonomously.

Why AI Agents Love Postiz

✓Every command returns structured JSON for easy parsing
✓Built-in SKILL.md provides full command documentation
✓Discovery workflow lets agents explore available platforms
✓Platform-specific tools (flairs, playlists, boards) are dynamically queryable
✓No SDK needed — any agent that can run CLI commands works
✓Model-agnostic — works with Hermes, Claude, GPT, or open-source LLMs

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
metadata:
  requirements:
    env:
      - POSTIZ_API_KEY
    binaries:
      - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

Command Reference

Command	Description
`postiz integrations:list`	List all connected social media accounts
`postiz integrations:settings <id>`	Get platform-specific settings schema
`postiz integrations:trigger <id> <method>`	Trigger platform tools (flairs, playlists, etc.)
`postiz posts:create`	Create and schedule a new post
`postiz posts:list`	List all scheduled and published posts
`postiz posts:delete <id>`	Delete a scheduled post
`postiz analytics:platform <id>`	Get analytics for an integration/channel
`postiz analytics:post <id>`	Get analytics for a specific post
`postiz upload <file>`	Upload media and get a reusable URL

25+ Supported Platforms

Connect once, post everywhere. Each platform has a dedicated guide with settings reference, CLI examples, and Hermes Agent workflows.

X (Twitter)

→

Tweets, threads, and reply controls

→

Professional posts and image carousels

Instagram

→

Feed posts, stories, and reels

Facebook

→

Text posts, links, and media

→

Subreddits, flairs, and post types

YouTube

→

Video uploads, thumbnails, and tags

TikTok

→

Videos, privacy, duets, and stitches

→

Pins, boards, and link pins

Discord

→

Channel messaging and media

Slack

→

Channel messaging and team updates

→

Bot-powered channel messaging

Twitch

→

Chat messages and announcements

Kick

→

Chat messages and notifications

Medium

→

Articles, publications, and tags

Dev.to

→

Developer articles and organizations

Hashnode

→

Blog posts and publications

WordPress

→

Posts, pages, and featured images

Dribbble

→

Design shots and team portfolios

Warpcast

→

Farcaster casts and channels

Lemmy

→

Federated community posts

Moltbook

→

AI agent social network

Google My Business

→

Business posts, events, and offers

Listmonk

→

Email campaigns and newsletters

Skool

→

Community posts and groups

Whop

→

Company forums and experiences

Frequently Asked Questions

What is Hermes Agent?

Hermes Agent is an open-source (MIT) autonomous AI agent by Nous Research. It runs on your own server, has persistent memory and auto-generated skills, and takes real actions on your behalf — including scheduling and publishing your social media through Postiz.

How do I add the Postiz skill to Hermes Agent?

Install Hermes with “curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash” and run “hermes setup”. Then add the Postiz skill with “npx skills add gitroomhq/postiz-agent” and set your POSTIZ_API_KEY. Hermes discovers it automatically.

What can Hermes Agent do with Postiz?

Hermes can draft, schedule, and publish posts, upload images and videos, create threads and comments, apply platform-specific settings, and pull analytics — across 30+ platforms, autonomously or on a natural-language schedule.

Which social media platforms are supported?

30+ platforms, including X (Twitter), LinkedIn, Instagram, Facebook, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Threads, Bluesky, Mastodon, and more.

Does it work with other AI agents?

Yes. Postiz Agent is a CLI, so any agent that can run shell commands works — including OpenClaw, Claude Code, and ChatGPT. You can also connect through the Postiz MCP server.