Post to Reddit from Hermes Agent

Hermes Agent can post to Reddit through Postiz. Once the Postiz skill is installed, you tell Hermes which subreddit, title, and post type you want from Telegram, Discord, Slack, or the CLI. It checks the subreddit's available flairs with Postiz, applies a required flair, adds a link or image, and schedules the post.

Setup Guide GitHub

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

Last updated: September 2026

Post to Reddit in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Hermes Agent:
> Post our tutorial to r/programming
  with the "Tutorial" flair, tomorrow at 9am

Hermes Agent: Done! Your Reddit post is scheduled.

Reddit-Specific Features

🎯

Subreddit Targeting

Post to one or multiple subreddits simultaneously. Target the exact communities where your content belongs.

📝

Post Types

Create self posts, link posts, image posts, or video posts. Each type is optimized for Reddit's native rendering.

🏷

Flair Support

Automatically discover and apply required flairs for each subreddit. Never have a post rejected for missing flair again.

🔄

Cross-Posting

Share content across multiple subreddits in a single request. Each subreddit gets its own title and flair configuration.

🔗

Link & Media Posts

Share URLs, images, or videos directly. Link posts drive traffic while media posts maximize engagement within Reddit.

📅

Scheduled Posting

Schedule Reddit posts for peak activity times. Hit the front page by posting when your target subreddits are most active.

How to post to Reddit from Hermes Agent

You describe what you want in plain language and Hermes Agent handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your Reddit Integration

Ask Hermes Agent whether your Reddit account is connected. It can also look up available flairs for any subreddit before posting.

Example conversation

> Is my Reddit account connected to Postiz?

Hermes Agent: Yes — your Reddit account is connected
  and ready. Want me to post something?

Choose Your Post Type

Reddit supports multiple post types. Self posts contain text, link posts share URLs, and image/video posts upload media directly. Pick the right type for your content.

Example conversation

> Draft a Reddit post about our new
  feature launch

Hermes Agent: Here's a draft for Reddit:
  "We just shipped something big..."
  Want me to add media and schedule it?

Create Your Post

Schedule a Reddit post with your content, target subreddit, post type, and flair. You can post to multiple subreddits at once by adding more items to the subreddit array.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Hermes Agent: Done! Scheduled on Reddit for
  tomorrow at 9:00 AM.

Reddit Settings Reference

Mention any of these in plain language and Hermes Agent sets them for you. These are the Reddit options it can apply to any post.

Field	Type	Required	Description
`__type`	string	Yes	Must be "reddit"
`subreddit`	array	Yes	Array of subreddit targets: [{value: {subreddit, title, type, url?, is_flair_required, flair?}}]
`subreddit[].value.subreddit`	string	Yes	Name of the subreddit to post to (without r/ prefix)
`subreddit[].value.title`	string	Yes	Title of the Reddit post
`subreddit[].value.type`	string	Yes	Post type: "self", "link", "image", or "video"
`subreddit[].value.url`	string	No	URL for link-type posts
`subreddit[].value.is_flair_required`	boolean	Yes	Whether the subreddit requires a flair
`subreddit[].value.flair`	object	No	Flair object with id and name (required if is_flair_required is true)
`subreddit[].value.flair.id`	string	No	Flair template ID from the subreddit
`subreddit[].value.flair.name`	string	No	Display name of the flair

Common Configurations

Ask Hermes Agent for any of these common Reddit scenarios and it applies the matching settings.

Simple Self Post

Just ask

> Post it with: Simple Self Post

Hermes Agent: Got it. Applying:
  subreddit: {'subreddit': 'programming', 'title': 'Check out this new AI scheduling tool', 'type': 'self', 'is_flair_required': False}

Link Post with Flair

Just ask

> Post it with: Link Post with Flair

Hermes Agent: Got it. Applying:
  subreddit: {'subreddit': 'webdev', 'title': 'How we built our scheduling engine', 'type': 'link', 'url': 'https://example.com/blog/scheduling-engine', 'is_flair_required': True, 'flair': {'id': 'abc123', 'name': 'Article'}}

Cross-Post to Multiple Subreddits

Just ask

> Post it with: Cross-Post to Multiple Subreddits

Hermes Agent: Got it. Applying:
  subreddit: {'subreddit': 'programming', 'title': 'New AI social media scheduler', 'type': 'self', 'is_flair_required': False}, {'subreddit': 'artificial', 'title': 'We just launched our AI social media scheduler', 'type': 'link', 'url': 'https://example.com/launch', 'is_flair_required': False}

Image Post

Just ask

> Post it with: Image Post

Hermes Agent: Got it. Applying:
  subreddit: {'subreddit': 'dataisbeautiful', 'title': 'Social media engagement trends 2025', 'type': 'image', 'is_flair_required': True, 'flair': {'id': 'def456', 'name': 'OC'}}

What is Hermes Agent?

Hermes Agent is an open-source AI agent from Nous Research, released under the MIT license. It runs on your own machine or server, you talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or the CLI, and it executes tools such as the Postiz skill to post to Reddit and other channels. It works with Nous Portal, OpenRouter, OpenAI, or your own model endpoint.

💬

Message From Anywhere

Talk to Hermes from Telegram, Discord, Slack, WhatsApp, Signal, email, or the terminal. Ask for a Reddit post from whichever app you already have open.

⏰

Built-in Cron Scheduler

Create recurring jobs in plain language, such as weekdays at 9am. Hermes drafts and schedules Reddit content through Postiz and reports back to your chat.

🔧

Open Source, Any Model

Hermes Agent is MIT licensed and self-hosted. Run it on Nous Portal, OpenRouter, OpenAI, or your own endpoint, and extend it with MCP servers or skills like Postiz.

How Postiz Works with Hermes Agent

Postiz ships as an agent skill in the agentskills.io SKILL.md format that Hermes Agent reads. The skill documents every Postiz CLI command, the credentials it needs, and the Reddit settings, so Hermes knows how to list your channels, upload media, and create posts without any custom code.

✓Install the Postiz CLI (npm install -g postiz) and add the skill with npx skills add gitroomhq/postiz-agent
✓Hermes loads skills from ~/.hermes/skills and shows them with hermes skills list
✓Authenticate with POSTIZ_API_KEY, or run postiz auth:login for an OAuth device flow
✓Every Postiz command returns JSON, so Hermes can chain discovery, upload, and posting
✓Prefer MCP? Add https://mcp.postiz.com/mcp-oauth-dynamic under mcp_servers in ~/.hermes/config.yaml

Install Postiz

# Install the Postiz CLI and skill
npm install -g postiz
npx skills add gitroomhq/postiz-agent

# Authenticate: API key or OAuth device flow
export POSTIZ_API_KEY=your_api_key
# or: postiz auth:login

# Confirm Hermes can see the skill
hermes skills list

Reddit Posting with Hermes Agent

Hermes Agent reads Postiz commands through its tool system, discovers your integrations, and handles the entire posting workflow — from content creation to scheduling.

🧠

From Any Chat App

Telegram, Discord, Slack, WhatsApp, Signal

Send a message to Hermes Agent from your favorite chat app. Its gateway runs in the background, so it picks up your message, discovers your Reddit account via Postiz, finds the right flairs, and schedules the post — all while you go about your day.

Hermes Agent

You: Post to Reddit about our new
  feature launch, schedule for tomorrow
  at 9am

Hermes: I'll handle that! Let me:
  1. Find your Reddit integration
  2. Compose your post content
  3. Schedule for tomorrow 9:00 AM

  Done! Post scheduled successfully.
  Post ID: abc-123

🧠

Scheduled & Proactive

Built-in Hermes cron jobs

Hermes Agent has a built-in cron scheduler. Create a recurring job in plain language and Hermes drafts and schedules your Reddit content through Postiz on that schedule, then reports back to whichever chat you use.

Hermes cron job

# From the terminal
hermes cron create "weekdays at 9am" \
  "Check ~/content/reddit for new posts.
   Upload any media with postiz upload,
   then schedule each one to Reddit
   for noon today via Postiz. Move posted
   files to ~/content/published."

# Or from any chat with Hermes
/cron add "weekdays at 9am" "Schedule
  today's Reddit post via Postiz"

Why Hermes Agent + Postiz for Reddit

Hermes Agent makes Postiz a natural fit for your Reddit workflow. The agent discovers all available commands and autonomously chains them together.

✓Hermes Agent is MIT licensed and Postiz has a public API, so nothing is locked in
✓Chat-first: ask for a Reddit post from Telegram, Discord, Slack, WhatsApp, or Signal
✓Cron jobs in plain language for hands-free recurring Reddit posts
✓Cross-post to Reddit and other channels in one request, each with its own settings
✓Model-agnostic: run Hermes on Nous Portal, OpenRouter, OpenAI, or your own endpoint
✓Credentials stay in Postiz; Hermes only holds a Postiz API key or OAuth session

SKILL.md (what Hermes reads)

---
name: postiz
description: Postiz is a tool to schedule
  social media and chat posts to 28+
  channels including Reddit
homepage: https://docs.postiz.com/public-api/introduction
---

# Commands Hermes can run
postiz auth:status
postiz integrations:list
postiz integrations:settings <id>
postiz upload <file>
postiz posts:create -i <id> -c "..." -s <iso>
postiz posts:list
postiz analytics:platform <id>

# Reddit settings
subreddit

Using a different agent for Reddit?

Postiz works with any AI agent that can run CLI commands or call MCP tools, and the Reddit settings on this page are the same for every agent. Read the same guide for Claude Code, OpenClaw, Codex. Or see the guide for any AI agent and the Postiz MCP server.

Reddit + Other Platforms

Schedule the same content to Reddit and other platforms in a single request. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  Reddit and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Reddit every weekday at 10am

Hermes Agent: Done! Scheduled:
  - Reddit + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Reddit: Mon-Fri 10:00 AM

What can you ask Hermes Agent to do on Reddit?

You can ask Hermes Agent to create, schedule, cancel, and measure Reddit posts in plain language. These are the kinds of requests it handles through Postiz.

Ask Hermes Agent

> Post our tutorial to r/programming as a link post titled "Scheduling posts from an AI agent" with the Tutorial flair, tomorrow at 9am.

Hermes fetches flairs with postiz integrations:trigger, sets type: link, the flair ID, and schedules the post.

Ask Hermes Agent

> Which flairs does r/SaaS require, and is a flair mandatory there?

Hermes queries the subreddit through Postiz and reports is_flair_required plus the flair list.

Ask Hermes Agent

> Cross-post this announcement as a text post to r/artificial and r/webdev with different titles.

Hermes builds a subreddit array with one entry per community and creates the post.

Reddit rules Hermes Agent has to follow

Postiz validates every Reddit post before it is scheduled, so these limits and required settings decide whether a request succeeds.

▸Every subreddit entry needs a title. Reddit titles are limited to 300 characters.
▸Some subreddits require a flair. Hermes must fetch the flair list first and pass the flair id when is_flair_required is true, or the post fails.
▸Post type matters: self for text, link for a URL, image or video for media. Link posts need the url field.
▸Subreddit names are passed without the r/ prefix. Posting identical content to many subreddits at once can trigger Reddit spam filters, so vary titles and spacing.

Hermes Agent and Reddit: frequently asked questions

Can Hermes Agent post to Reddit?

Yes. With the Postiz skill, Hermes Agent creates self, link, image, and video posts in any subreddit your connected Reddit account can post to. It fetches live flair lists, applies required flairs, cross-posts to several subreddits in one request, and schedules everything through Postiz CLI commands.

How do I connect Reddit to Hermes Agent?

Connect your Reddit account in the Postiz dashboard, then install the Postiz skill in Hermes with npx skills add gitroomhq/postiz-agent and set POSTIZ_API_KEY. Hermes finds the Reddit channel with postiz integrations:list. Your Reddit password stays in Postiz; Hermes only uses the Postiz key.

How does Hermes Agent handle subreddit flairs?

Before posting, Hermes runs postiz integrations:trigger to pull the subreddit's flair list and whether a flair is required. If it is, Hermes sets is_flair_required to true and passes the flair id and name you asked for. Without a required flair the post is rejected, so Hermes checks first.

Can Hermes Agent cross-post to multiple subreddits at once?

Yes. The Reddit settings accept an array of subreddit targets, each with its own title, type, and optional flair. Ask Hermes to post to several communities and it fills one entry per subreddit. Give each a slightly different title to avoid looking like spam to moderators.

Can Hermes Agent post to Reddit automatically on a schedule?

Yes. Hermes Agent has a built-in cron scheduler. Run hermes cron create "every friday 10am" with a prompt that tells it to summarize the week's release notes and post them to a chosen subreddit via Postiz. Hermes runs unattended and reports back to your chat.