Skip to main content

organum

Organism Engineering — a cognition & discipline layer for the agents you already run: persistent memory, differentiation, immunity (guard), and coordination without a dispatcher.

🫀 Live: https://ludex-lab.github.io/organum/

pip install organum

One package, one principle — surface agent state honestly, measure it, never fabricate. Everything below ships today (pre-1.0 beta; formats still moving):

Tool What it does
organum-inspector Post-hoc metering for AI coding agents — duration, tokens, tools per session, across six vendors (Cursor CLI added in 0.4.3). Read-only, zero setup. Manual · 한국어
organum web / observatory / health Live control tower · history that survives vendor cleanup · an immune system watching session stores. Detection only — never deletes, never kills
organum-hub New: 0.4.x — signed evidence envelopes between agent communities: signed receipts + a transparency log, verifiable offline. 0.4.0 adds git-less delivery: a minimal HTTP drop (serve/push/pull); 0.4.1 makes a long-running drop hostable: per-member token rate limits (429 + Retry-After), self-hosting still the default; 0.4.2 makes membership itself an audited event: introduce-signer admits a new lab into a live hub with no retroactivity — only the hub's operating lab can introduce, and envelopes verified before introduction formalize afterwards under the same event ids. Manual · 한국어

hub, in four sentences

Two agent workspaces exchange claims — "we froze this file", "here is a message for your agent" — as signed envelopes. There is no server and no trusted middleman: each party installs their own, and envelopes travel over any channel (files, chat, email). The trust lives in identity, not the channel — like registering a seal, one trustworthy public-key exchange bootstraps everything; after that, any envelope from any route verifies or it doesn't get in. Signed, not encrypted: what's blocked is forgery, tampering, and retroactive denial — secrecy is an explicit later layer, and the full residual list is printed in the manual rather than hidden.

The wire format is standard Nostr (NIP-01 + BIP-340), so existing relays work as carriers — interop with Block's Buzz was verified against a live relay (byte-identical round-trip; see the manual). hub is not a lightweight Buzz, though: Buzz is channels and workspace, hub is signed evidence and verification — different layers that happen to meet at a standard wire. No relay, and no Buzz, is required: file exchange is the default, dependencies are the Python standard library alone. And no git either: since 0.4.0 one side can run a minimal HTTP drop (organum-hub serve) and the peer's address is just (URL, pubkey) — the server is a dumb carrier that never verifies an envelope; verification stays at the receiving hub. Since 0.4.1 a drop can stay up as a neutral, gated mailbox: membership is closed by token issuance with per-member rate limits, so hosting cost stays bounded — this is how the labs building organum exchange their daily mail today. Where it's headed is a federated open protocol in the email–Matrix–Nostr lineage: identity anchored in pubkeys, servers open-source, the protocol open while each federation curates its own membership. Since 0.4.2 that curation is itself on the record: joining a hub is a signed, logged event that only the hub's operating lab can issue — "who admitted whom, and when" is part of the transparency log, symmetric with revocation.

Status: pre-1.0 · incubating under the Ludex lab. All research figures shown are in-lab, per their source labels, pending third-party replication.

Metadata

Release files for organum 0.4.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for organum 0.4.3
File Size Uploaded
organum-0.4.3.tar.gz 318.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for organum 0.4.3
File Interpreter ABI Platform
organum-0.4.3-py3-none-any.whl Python 3 none any Details

Total release size: 549.4 kB

Release files / organum-0.4.3.tar.gz

Download URL organum-0.4.3.tar.gz
Size 318.1 kB
Tags Source
SHA-256 checksum
How to use checksums
876bdb73fd8bf6d24f31955658df2e44d6bc6a953e8d68bc6c579f41e062572e
BLAKE2b-256 checksum
How to use checksums
2662173af74be76d55308f7fb131d8c1bd560631e708db79f2e3badbc5804231
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / organum-0.4.3-py3-none-any.whl

Download URL organum-0.4.3-py3-none-any.whl
Size 231.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
869219294b574319600e5febaca03facbe9c87135781c1d398dfada7b663af41
BLAKE2b-256 checksum
How to use checksums
c7e81b7b4100442ea0ffdda024166d858a828bce4358cbeb90f76aa4a1e7b4b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release history Release notifications | RSS feed

0.8.0

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.17

2 release files

0.4.16

2 release files

0.4.15

2 release files

0.4.14

2 release files

0.4.13

2 release files

0.4.12

2 release files

0.4.8

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

This release

0.4.3 This release

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page