anas/mem0-homelab
Watch
2
0
Fork
You've already forked mem0-homelab
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Sanitized public Hermes plugin and generic deployment examples for self-hosted Mem0 OSS.
2 commits 1 branch 2 tags 68 KiB
  • Python 98.6%
  • Shell 1.4%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
balnaimi f0581e8846 chore: verify Mem0 2.2.0 and package plugin 1.1.5
2026-09-25 18:22:39 +03:00
config chore: publish sanitized Mem0 self-hosted plugin 2026-08-28 16:08:55 +03:00
deploy chore: verify Mem0 2.2.0 and package plugin 1.1.5 2026-09-25 18:22:39 +03:00
dist chore: verify Mem0 2.2.0 and package plugin 1.1.5 2026-09-25 18:22:39 +03:00
docs chore: verify Mem0 2.2.0 and package plugin 1.1.5 2026-09-25 18:22:39 +03:00
plugin/mem0_selfhost chore: verify Mem0 2.2.0 and package plugin 1.1.5 2026-09-25 18:22:39 +03:00
scripts chore: publish sanitized Mem0 self-hosted plugin 2026-08-28 16:08:55 +03:00
.gitignore chore: publish sanitized Mem0 self-hosted plugin 2026-08-28 16:08:55 +03:00
LICENSE chore: publish sanitized Mem0 self-hosted plugin 2026-08-28 16:08:55 +03:00
README.md chore: verify Mem0 2.2.0 and package plugin 1.1.5 2026-09-25 18:22:39 +03:00
SECURITY.md chore: publish sanitized Mem0 self-hosted plugin 2026-08-28 16:08:55 +03:00

README.md

Mem0 Self-Hosted Hermes Plugin

A reusable, secret-free Hermes memory provider for the Mem0 OSS self-hosted API.

Included

  • plugin/mem0_selfhost/ — provider for /memories and /search.
  • scripts/install-hermes-plugin.sh — installs into $HERMES_HOME/plugins/.
  • scripts/smoke-test-api.py — add/search/delete smoke test with cleanup.
  • scripts/check_mem0_release.py — optional watcher for official Python SDK tags.
  • config/ — sanitized configuration examples.
  • deploy/ — generic LAN Compose override example.
  • docs/ — public installation and compatibility notes.
  • dist/ — portable plugin archive and checksum.

Security

This repository intentionally excludes real hostnames, private IPs, usernames, agent identities, .env files, API keys, JWT secrets, database passwords, dumps, credentials, and live memory data. See SECURITY.md.

Install

git clone https://git.majlis7.net/anas/mem0-homelab.git
cd mem0-homelab
./scripts/install-hermes-plugin.sh
cp config/mem0.json.example ~/.hermes/mem0.json
# Put the real MEM0_API_KEY and deployment-specific values in ~/.hermes/.env.
hermes config set memory.provider mem0_selfhost
hermes memory status

Use a unique API key and MEM0_USER_ID for each independent agent.

For an archive install, verify dist/SHA256SUMS before extracting the latest archive under $HERMES_HOME/plugins/.

Compatibility

mem0_selfhost version 1.1.5 is tested with Mem0 Python SDK / OSS 2.2.0. Track official vX.Y.Z releases rather than unreleased main commits.