Skip to content

feat(mem0): add self-hosted mode to the setup wizard - #60494

Merged
teknium1 merged 1 commit into
mainfrom
salvage/56943-mem0-self-hosted
Jul 7, 2026
Merged

feat(mem0): add self-hosted mode to the setup wizard#60494
teknium1 merged 1 commit into
mainfrom
salvage/56943-mem0-self-hosted

Conversation

@teknium1

@teknium1 teknium1 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

feat(mem0): add self-hosted mode to the setup wizard

Summary

hermes memory setup can now configure the mem0 plugin's self-hosted server mode — previously the wizard offered only Platform and OSS, so the self-hosted support merged in #56943 was reachable only by hand-editing mem0.json / .env (the exact gap reported by community users).

Changes

  • _setup.py: interactive picker now shows Platform / Self-hosted server / Open Source; new _setup_selfhosted() flow (host → mem0.json, optional API key → .env as MEM0_API_KEY, best-effort non-fatal reachability check); non-interactive via hermes memory setup mem0 --mode selfhosted --host http://... [--api-key ...] [--dry-run]
  • tests/plugins/memory/test_mem0_setup.py: 4 new tests (flag mode, AUTH_DISABLED no-key, dry-run, trailing-slash normalization)
  • plugins/memory/mem0/README.md + website/docs/user-guide/features/memory-providers.md: wizard path documented

Validation

Result
mem0 backend + v3 + setup suites 109 passed
Live E2E (real HTTP server) flag-driven setup → mem0.json/.env → SelfHostedBackend routing → live X-API-Key'd calls
ruff clean
Core files touched none — plugin dir + tests + docs only

Follow-up to #56943 (@kshitijk4poor / @kartik-mem0), which added the self-hosted backend but not the setup-UX integration. Closes the wizard gap from #52478.

Infographic

self-hosted mem0

@alt-glitch alt-glitch added type/feature New feature or request comp/plugins Plugin system and bundled plugins tool/memory Memory tool and memory providers P3 Low — cosmetic, nice to have labels Jul 7, 2026
The salvaged SelfHostedBackend made self-hosted servers reachable via
mem0.json / MEM0_HOST, but the setup wizard still offered only Platform
and OSS — exactly the gap users hit (Discord report: 'At memory setup
there's only 2 options'). Adds a third wizard mode:

- interactive picker: Platform / Self-hosted server / Open Source
- non-interactive: hermes memory setup mem0 --mode selfhosted
  --host http://... [--api-key ...] [--dry-run]
- host -> mem0.json (behavioral), API key -> .env as MEM0_API_KEY
  (secret), optional key for AUTH_DISABLED servers
- best-effort reachability check against the server, non-fatal
- README + memory-providers docs updated with the wizard path
@teknium1
teknium1 force-pushed the salvage/56943-mem0-self-hosted branch from b9d7add to f9f0201 Compare July 7, 2026 20:56
@teknium1 teknium1 changed the title feat(mem0): self-hosted server backend + setup wizard mode (salvage #56943) feat(mem0): add self-hosted mode to the setup wizard Jul 7, 2026
@teknium1
teknium1 merged commit 5e51b12 into main Jul 7, 2026
31 checks passed
@teknium1
teknium1 deleted the salvage/56943-mem0-self-hosted branch July 7, 2026 21:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/plugins Plugin system and bundled plugins P3 Low — cosmetic, nice to have tool/memory Memory tool and memory providers type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants