anas/mem0-homelab
Watch
2
0
Fork
You've already forked mem0-homelab
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Self-hosted Mem0 HomeLab deployment, Hermes plugin, release watcher, tests, and runbooks.
6 commits 1 branch 2 tags 181 KiB
  • Python 98.6%
  • Shell 1.4%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
balnaimi 768244e317 chore: release mem0_selfhost 1.1.3 for Mem0 2.0.16
2026-08-05 09:58:39 +03:00
config Initial Mem0 HomeLab integration 2026-07-25 00:36:19 +03:00
deploy chore: release mem0_selfhost 1.1.3 for Mem0 2.0.16 2026-08-05 09:58:39 +03:00
dist chore: release mem0_selfhost 1.1.3 for Mem0 2.0.16 2026-08-05 09:58:39 +03:00
docs chore: release mem0_selfhost 1.1.3 for Mem0 2.0.16 2026-08-05 09:58:39 +03:00
plugin/mem0_selfhost chore: release mem0_selfhost 1.1.3 for Mem0 2.0.16 2026-08-05 09:58:39 +03:00
scripts chore: release mem0_selfhost 1.1.2 for Mem0 2.0.15 2026-08-02 08:19:57 +03:00
.gitignore Initial Mem0 HomeLab integration 2026-07-25 00:36:19 +03:00
LICENSE Initial Mem0 HomeLab integration 2026-07-25 00:36:19 +03:00
README.md chore: release mem0_selfhost 1.1.3 for Mem0 2.0.16 2026-08-05 09:58:39 +03:00
SECURITY.md Initial Mem0 HomeLab integration 2026-07-25 00:36:19 +03:00

README.md

Mem0 HomeLab

Reusable, secret-free source for the Majlis7 self-hosted Mem0 deployment and Hermes integration.

Included

  • plugin/mem0_selfhost/ — Hermes memory provider for Mem0 OSS routes (/memories, /search).
  • scripts/check_mem0_release.py — silent watcher for official Python OSS tags matching vX.Y.Z; unrelated monorepo releases are ignored.
  • scripts/install-hermes-plugin.sh — installs the provider into $HERMES_HOME/plugins/.
  • scripts/smoke-test-api.py — add/search/delete API smoke test that cleans up its temporary record.
  • config/ — non-secret Hermes configuration examples.
  • deploy/ — LAN Compose customization example and deployment notes.
  • docs/ — architecture, deployment, maintenance, integration, and historical HomeLab notes.
  • dist/ — portable plugin archive plus checksum.

Security

This repository intentionally excludes .env, API keys, JWT secrets, dashboard passwords, database dumps, bootstrap credentials, and live memory data. See SECURITY.md.

Quick plugin install

git clone https://git.majlis.lab/anas/mem0-homelab.git
cd mem0-homelab
./scripts/install-hermes-plugin.sh
cp config/mem0.json.example ~/.hermes/mem0.json
# Add the real MEM0_API_KEY and agent-specific IDs to ~/.hermes/.env
hermes config set memory.provider mem0_selfhost
hermes memory status

Restart Hermes or its gateway after first enabling the provider. Each agent should use a separate API key and isolated MEM0_USER_ID.

For an archive-based install, download dist/mem0_selfhost-plugin-1.1.3-20260805.tar.gz, verify it with sha256sum -c dist/SHA256SUMS, and extract it under $HERMES_HOME/plugins/.

Update policy

Track and install official Mem0 releases only. Unreleased origin/main commits are not routine update candidates.