Xquik-dev
hermes-tweet
Native Hermes Agent plugin for X/Twitter automation via Xquik, offering 102 agent-callable endpoints.
Repository last updated Jul 24, 2026
Overview
Hermes Tweet is a plugin for Hermes Agent that integrates Xquik tools for X/Twitter automation. It provides 102 agent-callable endpoints generated from the Xquik OpenAPI specification, enabling AI agents to search posts, read timelines, export followers, and perform actions like posting or replying.
The plugin separates tools into three categories: tweet_explore for catalog discovery (no API call), tweet_read for read-only endpoints, and tweet_action for mutating or private endpoints. Actions are disabled by default and require explicit opt-in via the HERMES_TWEET_ENABLE_ACTIONS environment variable.
This plugin is ideal for developers building AI agents that need to interact with X programmatically, especially those using Hermes Agent as their framework. It includes a bundled Hermes Skill and two slash commands for quick status checks and trend viewing.
Highlights
- 102 agent-callable Xquik endpoints from OpenAPI
- Separate read and action tools for safety
- Actions disabled by default, opt-in required
- Bundled Hermes Skill and two slash commands
- API key injected at request time, never passed as argument
Features
Catalog-Guided Tool Selection
Use <code>tweet_explore</code> to search the bundled catalog without making an API call, then invoke the exact path with the appropriate read or action tool.
Safety-First Design
Tools never accept credentials as arguments; the API key is injected at request time. Admin, billing, and other sensitive routes are hidden from the agent catalog.
Slash Commands for Quick Insights
Use <code>/xstatus</code> to check Xquik account status and usage, or <code>/xtrends</code> to view current X trends.
Installation
Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.
hermes plugins install Xquik-dev/hermes-tweet --enableuv pip install --python ~/.hermes/hermes-agent/venv/bin/python hermes-tweet
hermes plugins enable hermes-tweethermes plugins install file:///absolute/path/to/hermes-tweet --force --enableRequirements
- Hermes Agent installed
- Python 3.12+
- Xquik API key (set as XQUIK_API_KEY environment variable)
How it's built
The plugin is written in Python and distributed as a PyPI package (hermes-tweet). It integrates with Hermes Agent via the plugin system, registering tools and slash commands. The repository includes a catalog generation script (scripts/build_catalog.py) that rebuilds the tool catalog from the canonical Xquik OpenAPI schema.
Key environment variables are XQUIK_API_KEY (required), XQUIK_BASE_URL (optional, defaults to https://xquik.com), and HERMES_TWEET_ENABLE_ACTIONS (set to true to enable mutating endpoints). The plugin uses uv for dependency management and includes fuzz testing, CI workflows, and security scanning.
Repository layout includes hermes_tweet/ for the main package, docs/ for integration guides, fuzz/ for fuzzing, and dashboard/ for a manifest. The plugin is licensed under MIT and is not affiliated with X Corp.
Source
This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The Xquik-dev/hermes-tweet repository is the authoritative source and the place to file issues or contribute.
Category: Messaging & Social · Licensed under MIT