What is hermes-s3-plugin?

This is a plugin for a tool called Hermes that adds the ability to back up files and folders to any S3 compatible cloud storage service, such as AWS S3, Cloudflare R2, or MinIO. Once installed, it lets you push files up to storage, pull them back down, list what is stored, and remove objects you no longer need. Most people would install it directly through Hermes with a single install command, or by copying the plugin folder into their Hermes plugins directory. Setup involves creating environment variables for your storage endpoint, region, bucket name, and access credentials, which should be kept in a private environment file and never committed to source control or placed directly in commands. Once configured, everyday use is a small set of commands: push a local file or folder up to a remote location, pull a remote prefix back down to your machine, list what exists under a given path, or delete a specific object, which requires an extra confirmation flag as a safety check. Uploading skips files that already exist unless you explicitly ask it to overwrite them. You can also define named, reusable backup rules in a YAML file, so a command like a daily backup can be run repeatedly without retyping the source and destination each time, and these rules support placeholders for the current date. Every command outputs a simple JSON result, which makes it easy to use from scripts. The plugin requires Python 3.10 or newer along with the boto3 and PyYAML libraries, and it is released under the MIT license.