Deploy Your AI Hermes Agent in Minutes with PPHermes Cloud Sandbox

PPHermes is a Python‑based CLI tool that lets you launch a Hermes Agent sandbox in the cloud without writing code. It offers three deployment models—local/Docker, SSH‑based VPS, and a fully managed cloud sandbox—each with distinct advantages and trade‑offs.

Installation Prerequisites

Windows : Download Python 3.9+ from the official site, check "Add Python to PATH", and run the installer.

macOS : Open Terminal and verify Python version with python3 --version. If missing or older than 3.9, install via Homebrew: brew install python.

Linux (Ubuntu) : Run

sudo apt update && sudo apt install python3 python3-venv python3-pip -y

in a terminal.

Obtain a PPIO API Key

Log in to the PPIO console, navigate to the API Key management page, and create a new key. Copy the sk_... string; it is shown only once.

Install PPHermes

For macOS/Linux, execute:

curl -fsSL https://pphermes.ppio.com/install.sh | bash

For Windows PowerShell, execute: irm https://pphermes.ppio.com/install.ps1 | iex Alternatively, install via pip: pip install pphermes Verify the installation with: pphermes --help The command should display usage information, confirming a successful install.

Configure the API Key

Set the key as an environment variable to avoid passing it each time: export PPIO_API_KEY=sk_xxx You can also supply it directly with the --api-key flag.

Launch the Hermes Agent Sandbox

Run the launch command: pphermes launch After about 60 seconds, the CLI prints sandbox details, including Sandbox ID, state, and URLs for the Hermes Web UI, Web Terminal, and File Manager, as well as autogenerated service credentials.

Sandbox Lifecycle Management

Pause (preserves state, no charges): pphermes pause <Sandbox ID> Resume (seconds to restore): pphermes resume <Sandbox ID> Stop (irreversible destruction):

pphermes stop <Sandbox ID>

Advanced Integration with Feishu/Lark

PPHermes includes a pair feishu subcommand. Use WebSocket mode for a direct connection:

pphermes pair feishu <sandbox-id> \
  --app-id cli_xxx \
  --app-secret secret_xxx \
  --mode websocket

Or use webhook mode, configuring the callback URL on the Feishu Open Platform:

pphermes pair feishu <sandbox-id> \
  --app-id cli_xxx \
  --app-secret secret_xxx \
  --mode webhook \
  --verification-token <TOKEN>

For Lark (Feishu overseas), replace --domain feishu with --domain lark.

AI‑Agent Skill Integration

PPHermes provides a skill file ( https://pphermes.ppio.com/skill.md) that AI agents such as Claude Code, Cursor, or Windsurf can consume to automatically install the CLI, set the API key, and launch a sandbox using natural‑language commands.

REST API Access

The sandbox also exposes a REST API at https://pphermes.ppio.com/api (interactive docs at /api/docs). Authenticate with Authorization: Bearer <PPIO_API_KEY>.

For full documentation, see https://ppio.com/docs/sandbox/hermes-agent/quickstart.