graphiti icon indicating copy to clipboard operation
graphiti copied to clipboard

✨ [Enhancement] Adopt uv workspace for local monorepo development (graphiti-core, mcp_server, server)

Open MumuTW opened this issue 6 months ago • 4 comments

🗂️ Background

Currently, the graphiti project is split into multiple subprojects (graphiti_core, mcp_server, server), but there is no workspace configuration.
This forces local development to rely on hardcoded file:// paths or manual pip install -e ...


✅ What I expected

  • A proper uv workspace or poetry workspace at the repo root.
  • All submodules should declare [tool.uv.sources] with workspace = true for local modules.
  • Local graphiti_core changes should automatically propagate to mcp_server and server without needing repeated reinstalls.

⚡ What actually happens

  • Local development requires hardcoding absolute file:// paths to the local graphiti-core in each pyproject.toml.
  • This breaks PEP 508 compliance if the path is not portable across machines.
  • Developers have to run uv sync --reinstall frequently to fix mismatched builds.

🧩 Proposed solution

Add a workspace definition at the repo root:

[tool.uv.workspace]
members = [".", "mcp_server", "server"]

In each member’s pyproject.toml, declare:

[tool.uv.sources]
graphiti-core = { workspace = true }

Document this in README.md or CONTRIBUTING.md.

🙌 Benefits

  • Zero hardcoding.
  • Faster dev iteration.
  • Fully PEP 508-compliant.
  • Better DX for new contributors.

✨ Extra context

I tested this locally and confirmed:

  • uv sync correctly resolves the local core package.
  • mcp_server and server immediately see code changes in graphiti_core.
  • No more Failed to generate package metadata errors.

Happy to send a PR if you want! Just let me know if you prefer uv workspace or poetry workspace. 🫶

MumuTW avatar Jul 14 '25 11:07 MumuTW

I agree...how do we get more support on this recommendation?

kcsf avatar Jul 30 '25 15:07 kcsf

@MumuTW Is this still relevant? Please confirm within 14 days or this issue will be closed.

claude[bot] avatar Oct 05 '25 00:10 claude[bot]

@MumuTW Is this still an issue? Please confirm within 14 days or this issue will be closed.

claude[bot] avatar Oct 22 '25 00:10 claude[bot]

@MumuTW Is this still relevant? Please confirm within 14 days or this issue will be closed.

claude[bot] avatar Nov 17 '25 00:11 claude[bot]