Learn how to build with Karp.

Karp makes it easy to deploy a private Hermes AI agent to the cloud. Follow these steps to get your first agent running.

Once deployed, visit the agent's detail page in your dashboard to view real-time logs, memory entries, and created skills.

SOUL.md is a Markdown file that defines your agent's personality, capabilities, tone, and operating principles. It is injected as a system prompt at the beginning of every session.

You can think of it as a combination of a job description, a personality profile, and a rules document — all in one.

# Agent Identity
You are a personal assistant named Aria, deployed via Karp.
You are proactive, concise, and genuinely helpful.

# Core Goals
- Help the user with research, writing, and task management
- Learn from every interaction to serve them better
- Create skills when you encounter repeatable tasks

# Constraints
- Always confirm before sending emails on the user's behalf
- Do not access external URLs unless explicitly asked
- Respond in the user's language

# Communication Style
- Be direct and efficient — avoid filler phrases
- Use bullet points for lists, prose for explanations
- Occasionally use light humour when appropriate

SOUL.md is editable at any time from the agent Settings page. Changes take effect on the next session start.

Your Hermes agent can receive and send messages across multiple platforms using a single unified memory. Each channel requires a token or webhook URL.

After entering your token in the agent settings, the channel will be listed as Connected with a green indicator. WeChat uses a separate configuration card below the channel list. The agent will begin responding within seconds of receiving its first message.

Hermes uses a multi-tier memory architecture that persists across all sessions and channels.

Memory entries are visible in the Memory tab of each agent. You can view, search, and delete individual entries. On the Free plan, episodic and semantic memory is retained for 7 days. Paid plans retain memory indefinitely.

Memory consolidation runs automatically after each session — the agent extracts key facts and preferences and stores them as semantic memories for future reference.

One of Hermes's most powerful features is autonomous skill creation. When the agent encounters a task it performs repeatedly, it writes a reusable Python function (a "skill") and saves it to its skill library.

The skill lifecycle has three phases:

All created skills are visible in the Skills tab of your agent. You can view the source code, rename, disable, or delete individual skills. Skills are sandboxed and run in an isolated environment.

The Karp REST API lets you manage agents, trigger actions, and query state programmatically. All endpoints require a Bearer token from your account settings.

Authorization: Bearer karp_live_xxxxxxxxxxxxxxxxxxxx

curl -X POST https://karpdo.ai/api/agents \
  -H "Authorization: Bearer karp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Assistant",
    "llm_provider": "openai",
    "llm_api_key": "sk-...",
    "soul_md": "# Identity\nYou are a helpful assistant."
  }'