181079342/hermes-memoss

Name: hermes-memoss
Author: 181079342

hemes 的memos记忆插件

★ 0 langPython updated2026-08-31

overview

MemOS Memory Plugin for Hermes Agent connects a Hermes Agent to a self-hosted MemOS instance for persistent memory storage. It provides semantic search, fact extraction, and multi-dimensional storage for text, preferences, tools, skills, and parameters.

Supports semantic search and automatic conversation persistence.
Includes a circuit breaker for MemOS API outages.
Provides tools for searching, adding, and deleting memories.

full readme from github

MemOS Memory Plugin for Hermes Agent

A Hermes Agent plugin that connects to a self-hosted MemOS instance for persistent memory storage with semantic search, fact extraction, and multi-dimensional memory.

Features

Semantic Search: Query memories by meaning, not just keywords
Multi-dimensional Storage: Text, preference, tool, skill, parameteric memories
Auto-sync: Automatically persists conversation turns to memory
Prefetch: Background recall before each turn
Circuit Breaker: Handles MemOS API outages gracefully

Installation

# Install into Hermes plugins directory
mkdir -p ~/.hermes/plugins/memoss
cp -r <this-repo>/plugins/memoss/* ~/.hermes/plugins/memoss/

Or clone directly:

git clone https://github.com/<your-org>/hermes-memoss.git ~/.hermes/plugins/memoss

Configuration

1. Set Environment Variables (in `~/.hermes/.env`)

MEMOSS_HOST=http://localhost:8002
MEMOSS_API_KEY=your-api-key   # optional if MemOS AUTH_DISABLED
MEMOSS_USER_ID=yangzj         # optional, for memory isolation
MEMOSS_AGENT_ID=hermes        # optional

2. Enable in config.yaml

memory:
  provider: memoss
  memory_enabled: true

3. Restart Hermes

# CLI mode
hermes

# Gateway mode
hermes gateway restart

Tools

Tool	Description
`memoss_search`	Semantic search memories
`memoss_add`	Store a new fact/memory
`memoss_delete`	Delete memory by ID

MemOS API Reference

This plugin connects to MemOS APIs:

POST /product/search - Semantic search
POST /product/add - Add memory
POST /product/delete_memory - Delete memory
POST /product/get_memory - Get all memories for a cube

Requirements

MemOS server running (default: http://localhost:8002)
Python 3.9+
httpx (included in Hermes venv)

License

Apache-2.0 (same as MemOS)