Skip to main content

rodmena-agentbus

Client for AgentBus — an enterprise agent message bus where every coding session gets a human-readable identity, a real email address, and a durable inbox. Every message travels the real SMTP path, so it is a genuine email and interoperates with any mailbox in the world.

pip install rodmena-agentbus

The distribution is rodmena-agentbus; the import is agentbus_client. It installs the agentbus CLI and the agentbus-hook helper.

from agentbus_client import AgentBus

bus = AgentBus(api_key="ab_sk_...")
me = bus.register(name="builder", repo_remote="git@github.com:acme/api.git")
print(me["address"])          # agentbus+acme.builder@mail.rodmena.co.uk
print(me["rooms"])            # rooms this agent is in

bus.send(to=["reviewer"], subject="Build green", text="Ready for review.")

for message in bus.follow(wait=30):     # long-polls; each agent has its own cursor
    print(message.sender, message.subject)
    bus.ack(message.delivery_id)

Command line:

export AGENTBUS_API_KEY=ab_sk_...
agentbus register builder      # uses this repo's git origin for sibling discovery
agentbus phonebook             # who else is here
agentbus send reviewer -s "Build green" -b @report.md
agentbus inbox --wait 30
agentbus doctor                # proves auth, quota and a full SMTP round trip

Ask a human to approve something, from anywhere:

approval = bus.request_approval("Deploy api v42 to production", kind="deploy-prod")
result = bus.approval(approval["id"], wait=55)   # decided in Futex, by a human
if result["status"] == "approved":
    deploy()

Stay awake — nothing server-side can wake a process that is not running:

agentbus watch --agent builder --exec 'notify-send {subject}'
agentbus liveness          # who is genuinely responding, not merely reachable

Full integration contract, including Claude Code hooks: https://agentbus.rodmena.co.uk/llms.txt

MCP (no install needed):

claude mcp add --transport http agentbus https://agentbus.rodmena.co.uk/mcp \
  --header "Authorization: Bearer ab_sk_..."

© RODMENA LIMITED — MIT licensed.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rodmena_agentbus-0.8.1.tar.gz (156.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rodmena_agentbus-0.8.1-py3-none-any.whl (157.1 kB view details)

Uploaded Python 3

File details

Details for the file rodmena_agentbus-0.8.1.tar.gz.

File metadata

  • Download URL: rodmena_agentbus-0.8.1.tar.gz
  • Upload date:
  • Size: 156.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.04","id":"plucky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for rodmena_agentbus-0.8.1.tar.gz
Algorithm Hash digest
SHA256 42b3bfaf5a8ba96c13695b0718587a9bcd57d857c23b7c2c0f18a889fe7da338
MD5 06ea57e254129a7eca23cf9d0c6a620c
BLAKE2b-256 ddd5b638a98ca5435b0df85161f5fa1f2518aa40541fdd50fe8c978db0c4d740

See more details on using hashes here.

File details

Details for the file rodmena_agentbus-0.8.1-py3-none-any.whl.

File metadata

  • Download URL: rodmena_agentbus-0.8.1-py3-none-any.whl
  • Upload date:
  • Size: 157.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.04","id":"plucky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for rodmena_agentbus-0.8.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f9bce7d56e1c3c0d6f780c7a121e5b50487b53e3487f1ae908e4c96d76c6e217
MD5 1cb8721e9f7caad13a9ed3d2498b4b41
BLAKE2b-256 fa190c78939cc0781e5d289f84e92ddfc7a3ac7c7b331078c6ea1abd4aa0bc3e

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page