omnigent-plur
Persistent memory for OmniGent agents,
powered by PLUR. OmniGent governs and composes
agents but has no memory; omnigent-plur plugs PLUR in so an agent corrected on
Monday remembers on Tuesday — across sessions and harnesses.
Status: v0 / alpha. Validated on real infrastructure: the agent-driven MCP path and the auto-learn policy run on stock OmniGent; auto-recall uses the upstream
context_providershook (proven end-to-end with a live model). See DESIGN.md.
How it works
It wraps PLUR (never reimplements it): all memory goes through the published
plur-mcp stdio server over MCP. Three layers, via OmniGent's own extension seams:
- Agent-driven (stock OmniGent) — declare PLUR as an MCP tool; the agent calls recall/learn.
- Auto-learn (stock OmniGent) — a request-phase policy captures corrections automatically.
- Auto-recall (needs the
context_providershook) — a per-turn provider injects recalled engrams into the system prompt, additively.
Install
pip install omnigent-plur # once published
# from source:
pip install -e ".[dev]"
Requires the PLUR MCP server on PATH (plur-mcp, from @plur-ai/mcp). Auto-recall
requires an OmniGent build with the context_providers hook.
Quickstart
omnigent run examples/plur_agent.yaml -p "fix the deploy script"
Pieces
| File | Role |
|---|---|
omnigent_plur/plur_client.py |
The only code that talks to PLUR (plur-mcp over MCP). |
omnigent_plur/policy.py |
plur_autolearn — request-phase auto-learn policy. |
omnigent_plur/providers.py |
recall — per-turn auto-recall context provider. |
examples/plur_agent.yaml |
Working agent spec wiring all three layers. |
Develop
pip install -e ".[dev]"
ruff check . && ruff format --check . && pytest -q
Apache-2.0.
1 maintainer
Metadata
1 maintainer
Release files for omnigent-plur 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| omnigent_plur-0.1.0.tar.gz | 21.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| omnigent_plur-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.4 kB
Release files / omnigent_plur-0.1.0.tar.gz
| Download URL | omnigent_plur-0.1.0.tar.gz |
|---|---|
| Size | 21.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8bed2c60eebe36688b8109eb76081b3c93385cecb5729694e1bf63e84221931d
|
|
BLAKE2b-256 checksum How to use checksums |
fac593e26e1f2ab789a340af73e3297d3ab4d172eaf9162de9c97316d6957461
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.
Transparency logRelease files / omnigent_plur-0.1.0-py3-none-any.whl
| Download URL | omnigent_plur-0.1.0-py3-none-any.whl |
|---|---|
| Size | 10.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d64e90a88d2f94e3f10f6b00e1ab7d68d87d39648bbe2e9d5602d11b105c90e5
|
|
BLAKE2b-256 checksum How to use checksums |
59dc759f891987425fb04762adf7195201cf0e9b0be2cdfd266f502a387cbbec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.
Transparency log
