Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getpatter.com/llms.txt

Use this file to discover all available pages before exploring further.

Hermes Agent is a self-hosted AI assistant that grows with you through modular skills and persistent memory. Once you install the Patter skill, your Hermes Agent can place outbound calls, receive inbound calls, and use the full Patter SDK without any further setup on the Hermes side.

​
Install

Patter skills work in every agent harness that consumes the Anthropic Agent Skills standard — Hermes Agent included. Install with one command: 
# Install all five Patter skills
npx skills add patterai/skills

# Or install just the one you need
npx skills add patterai/skills --skill build-voice-agent
The CLI auto-detects Hermes Agent on your machine and creates symlinks from ~/.hermes/skills/ (or your HERMES_HOME override) into the canonical ~/.agents/skills/ directory. Restart your Hermes Agent and the agent will pick the skills up at session start.
Pin to a specific Patter SDK version for reproducibility:
npx skills add patterai/skills#v0.6.2 --skill build-voice-agent

​
Available skills

SkillWhat it teaches the agent
setup-patterWalk the user through installing Patter and obtaining provider/carrier API keys, with validation.
build-voice-agentBuild a voice agent — pick between OpenAI Realtime / ElevenLabs ConvAI / STT→LLM→TTS Pipeline.
configure-telephonyWire up Twilio or Telnyx — phone numbers, webhooks, tunnels, AMD, voicemail drop.
add-tools-and-handoffsCustom tools, transfer_call, end_call, output guardrails.
inspect-calls-and-metricsLive dashboard, CallMetrics, cost tracking, CSV/JSON export.
Every skill ships full Python and TypeScript code examples side-by-side. Your Hermes Agent can pick the runtime that matches the rest of your project.

​
Use Patter as an MCP server (alternative path)

If you want Hermes Agent to call Patter through the Model Context Protocol instead of (or in addition to) the skills, register the Patter MCP server with one command: 
hermes mcp install patter-voice '{
  "command": "npx",
  "args": ["-y", "getpatter-mcp"],
  "env": {
    "TWILIO_ACCOUNT_SID": "AC...",
    "TWILIO_AUTH_TOKEN": "...",
    "OPENAI_API_KEY": "sk-..."
  }
}'
The Patter MCP server is hosted at PatterAI/patter-mcp. Once registered, tools surface to your Hermes Agent under names like patter-voice__make_call, patter-voice__get_transcript, and patter-voice__list_calls.
Allowlist outbound calls. By default, Hermes Agent may invoke MCP tools without explicit approval. If you don’t want your agent dialing arbitrary numbers without confirmation, configure tools.confirm: ["patter-voice__make_call"] in your Hermes Agent ~/.hermes/config.yaml, or wrap the tool in a small plugin that gates it behind user approval.

​
Use as an optional plugin

Hermes Agent supports plugin-based integrations. A Patter bundle — an optional-mcps/patter-voice manifest plus a bundled patter-voice skill — is proposed for the Hermes catalog in NousResearch/hermes-agent#33937. Once it is merged upstream, a single command installs both the MCP tools and the skill: 
hermes plugin add patter-voice
Until then, install Patter via the skills (npx skills add patterai/skills) or the MCP server path described above — both work today, with no upstream dependency.

​
Quick start: outbound call from Hermes Agent

Once skills are installed and your provider/carrier keys are in ~/.hermes/.env, ask your Hermes Agent something like:
“Call my plumber at +15550001234 and ask if they have time tomorrow morning. Then text me the summary.”
The agent loads build-voice-agent automatically (its description triggers on phrases like “call”, “phone”, “voicemail”), writes a small Python or TypeScript script using the Patter SDK, runs it, and reports the transcript back to you in the Hermes thread. If you’d prefer to skip the per-call SDK script and have the agent use the MCP server tools directly, ensure patter-voice is in your tools.allow list: 
# ~/.hermes/config.yaml
tools:
  allow:
    - bundle-mcp
    - patter-voice__*

​
What’s next

  • Read the Concepts page to understand Patter’s three modes (Realtime / ConvAI / Pipeline) and which one matches your latency / cost trade-off.
  • Get a phone number: Twilio console or Telnyx portal.
  • Provision your provider keys: the setup-patter skill walks the agent (and you) through every provider dashboard, one at a time, with curl validation for each key.
  • Browse the skill content: https://github.com/PatterAI/skills.

​
Need help?