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 five vendors. 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.2

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.2
File Size Uploaded
organum-0.4.2.tar.gz 316.0 kB Details

Built distribution (wheel)

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

Total release size: 546.3 kB

Release files / organum-0.4.2.tar.gz

Download URL organum-0.4.2.tar.gz
Size 316.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f4459d4d20ddee80eaa3bb84474b3f7521a009eef0a672d4467658891e9fa6a9
BLAKE2b-256 checksum
How to use checksums
05de0c621d186b8d616558f88c6033dca3f0a19c8a8836150a2b7a310e0f77b4
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.2-py3-none-any.whl

Download URL organum-0.4.2-py3-none-any.whl
Size 230.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
696f026541543cc5e01270e81b9dbc27b2f00ba933f7a75b614554b4de2e63c9
BLAKE2b-256 checksum
How to use checksums
3e64f2c2f22aaa04c3aa245a4685f7973402181203680e2b30ea87de873fa877
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

0.4.3

2 release files

This release

0.4.2 This release

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