Skip to content

Update installation script link#201

Merged
AxDSan merged 1 commit into
AxDSan:mainfrom
0rangeFox:patch-1
May 30, 2026
Merged

Update installation script link#201
AxDSan merged 1 commit into
AxDSan:mainfrom
0rangeFox:patch-1

Conversation

@0rangeFox
Copy link
Copy Markdown
Contributor

Description

As the title says, it's using the outdated url for "One-Liner Deploy" and it's updated for new script url also with an suggestion on Hermes Integration section.

Related Issue

Closes #(issue)

Type of Change

  • Bug fix
  • New feature
  • Documentation update
  • Refactor / performance
  • Test improvement
  • CI / build tooling

How Has This Been Tested?

  • Existing tests still pass (pytest tests/ -v)
  • New tests added for any new functionality
  • Manual verification (describe what you tested)

Checklist

  • Version bumped in mnemosyne/__init__.py
  • CHANGELOG.md updated with a brief entry
  • README updated if user-facing behavior changed
  • Code follows the project's principles:
    • No new external dependencies without good reason
    • No cloud / API key requirement for core functionality
    • SQLite is the only database dependency

@AxDSan AxDSan added the documentation Improvements or additions to documentation label May 29, 2026
@AxDSan AxDSan self-assigned this May 29, 2026
@0rangeFox
Copy link
Copy Markdown
Contributor Author

0rangeFox commented May 29, 2026

I think we could use this PR to update some instructions about installing because for me is a bit confuse, looks there's 3 ways to setup it for "Hermes Agent".

  1. The first one, through the README, on section Hermes Plugin (23 tools), using the pip install mnemosyne-hermes for all-in-one, and below on that description there's a link where forwards to 3rd point.
  2. On Integration Documents, also there's a option for "Hermes Agent" instructions which also redirect to another "all-in-one" tool by using the script provided on this repo.
  3. The last one, Hermes Integration inside of Documents folder, has totally another way to install the memory system and plugin.

Also, I would like to report too, I'm on MacOS, with Hermes Agent v0.15.1 (v2026.5.29) and installed via their bash script, and when I install this memory system through the install.sh script gives an error:

═══════════════════════════════════════════════════════════
  Mnemosyne Installer for Hermes Agent
═══════════════════════════════════════════════════════════

📁 Hermes home: /Users/0rangefox/.hermes
📁 Hermes venv: /Users/0rangefox/.hermes/hermes-agent
📁 Mnemosyne source: /Users
📁 Plugin target: /Users/0rangefox/.hermes/hermes-agent/plugins/memory/mnemosyne

✓ Hermes found
🔗 Creating symlink...

📦 Installing dependencies into Hermes venv...
⚠️  Hermes venv not found, installing to system Python...
bash: line 101: pip: command not found

But I actually checked and there's venv inside of /Users/0rangefox/.hermes/hermes-agent folder, and to be able to install this I was needed to execute the following commands in this order:

cd ~/.hermes/hermes-agent/venv
uv pip install fastembed
uv pip install mnemosyne-memory
./bin/python -m mnemosyne.install
hermes memory setup
hermes tools disable memory

Or I could do this way too, which I think is better way to do:

cd ~/.hermes/hermes-agent/venv
uv pip install fastembed
uv pip install mnemosyne-hermes
./bin/python -m mnemosyne.install
hermes memory setup
hermes tools disable memory

Just a side note, for upgrade, it's necessary to do the following commands:

cd ~/.hermes/hermes-agent/venv
uv pip install --upgrade mnemosyne-hermes && hermes gateway restart

@AxDSan
Copy link
Copy Markdown
Owner

AxDSan commented May 30, 2026

@0rangeFox appreciate you catching the dead URL. The one-line fix is correct and I'm merging it.

But your comment is the real value here. You hit the pain points:

  1. Three competing install methods. README says pip install. Integrations page says run a script. The hermes-integration.md doc says something else. A new user lands and has no idea which path to take. That's a conversion killer.

  2. The install script breaks on MacOS. It fails to find the venv, falls back to system Python, then crashes because pip isn't on the PATH. Every MacOS + Hermes user hits this.

  3. The upgrade path is undocumented. You had to reverse-engineer it yourself.

If you're up for it, I'd love your help on making this right. The goal is one install method, tested on MacOS + Linux, with the other docs deleted to prevent confusion. I just opened issue #204 tracking this.

Would you be interested in taking a pass at the install script fix? Happy to point you at the relevant parts.

Merging your PR now. Thanks for the contribution.

@AxDSan
Copy link
Copy Markdown
Owner

AxDSan commented May 30, 2026

Correction: the companion issue is #208 (not #204).

@AxDSan AxDSan merged commit 63b1394 into AxDSan:main May 30, 2026
AxDSan added a commit that referenced this pull request Jun 1, 2026
This release includes contributions from 6 contributors across 36 commits:

Added:
- sync_roles config for role-based autosave filtering (bitr8, #209)
- sync_turn content limit env vars
- Fact recall merged into standard recall path (MNEMOSYNE_FACT_RECALL_ENABLED)
- Auto-default scope=global when extract=true
- fact_recall() now searches consolidated_facts
- MNEMOSYNE_EMBEDDING_API_URL independent of OPENROUTER_BASE_URL (mia-fourier, #206)

Fixed:
- remember() silently never stored embeddings
- Hardcoded EMBEDDING_DIM=384 across 3 files + 1 test (Whishp, #200)
- Plugin dir named 'mnemosyne' shadows pip package (#212)
- Cross-session deletion of scope=global memories blocked (#204)
- _vec_insert() ran inside deferred transaction (chinesewebman)
- symlink rmtree crash on upgrade path
- Windows directory junctions (no admin required)
- Dead hermes_plugin tests breaking CI

Changed:
- Modular Hermes provider (2007-line split into 5 modules)
- Consolidated extensions/ and hermes/ into integrations/
- Dropped Python 3.9 CI support

Docs: benchmarks restored, plugin section revamped, standalone README,
multilingual setup, UPDATING.md updated, install script link fixed (Joao Fernandes, #201)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants