integration-r2

Connect Cloudflare R2 object storage to a self-hosted Hermes agent over SSH.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill integration-r2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-r2
Source: https://github.com/paarths-collab/hstack/tree/main/skills/integration-r2
Command: npx skills add https://github.com/paarths-collab/hstack --skill integration-r2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects Cloudflare R2 to a self-hosted Hermes agent so AI coding assistants can store and retrieve files without manual server setup, fragile ad hoc scripts, or expensive egress fees.

Core Features & Use Cases

  • SSH-first configuration: Writes R2 credentials and endpoint settings directly on the remote VPS running Hermes.
  • S3-compatible storage access: Uses Cloudflare R2’s S3 API with Access Key ID, Secret Access Key, and the custom R2 endpoint.
  • Safe operational workflow: Validates formats, checks live bucket reachability, shows a dry run, reloads the gateway, and includes rollback steps.
  • Common use cases: Store generated images and audio, handle uploads and downloads from messaging integrations, and provide object storage for AI agent workflows.

Quick Start

Ask the AI to connect your Cloudflare R2 bucket to the remote Hermes agent by collecting the VPS and bucket details, validating the credentials, writing the configuration, reloading Hermes, and confirming the bucket is reachable.

Frequently Asked Questions about integration-r2

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Cloudflare R2 object storage to a remote Hermes agent over SSH?

Connect Cloudflare R2 to a remote Hermes agent by writing S3-compatible credentials and auto-region endpoint settings directly to the VPS environment over SSH, validating formats, and reloading the gateway. This enables durable file storage for AI workflows without manual server setup.

What's the best way to configure S3-compatible R2 credentials for a self-hosted AI agent?

Configuring R2 credentials for a self-hosted AI agent requires writing the Access Key ID, Secret Access Key, and custom R2 endpoint into the remote environment. The process includes idempotent environment writes and live bucket verification to ensure reachability.

Does the Hermes R2 integration support rollback if the bucket connection fails?

The Hermes R2 integration supports rollback-safe gateway reloading. If the live bucket verification fails after writing credentials and reloading the gateway, the workflow includes rollback steps to restore the previous configuration safely.

Can I use Cloudflare R2 to store generated media and messaging uploads from AI workflows?

Cloudflare R2 can store generated images, audio, messaging uploads, and downloadable assets for AI agent workflows. Connecting it to Hermes provides S3-compatible object storage access, avoiding expensive egress fees associated with manual server setups.

How does live bucket verification work when connecting R2 storage to Hermes?

Live bucket verification checks R2 reachability after writing credentials and before finalizing the gateway reload. The workflow validates credential formats, shows a dry run, verifies the bucket is live, and applies rollback steps if the connection fails.

Do I need SSH access to configure R2 object storage for a remote Hermes deployment?

SSH access is required to configure R2 object storage for a remote Hermes deployment. The integration uses an SSH-first configuration approach to write R2 credentials and endpoint settings directly on the remote VPS running the Hermes agent.