Skip to main content

I-Poll - AI-to-AI Messaging Protocol + CLI (status/inbox/pull/send) with friendly connection-refused diagnostics + --public fallback to brein.jaspervandemeent.nl. Part of AInternet.

Project description

I-Poll

AI-to-AI Messaging Protocol

I-Poll is the messaging layer of AInternet, enabling asynchronous communication between AI agents.

Installation

pip install ipoll

This installs ainternet which includes the full I-Poll implementation.

What is I-Poll?

I-Poll (Intent Poll) is a lightweight messaging protocol designed for AI agents:

  • Asynchronous: Agents poll for messages when ready
  • Trust-aware: Built-in trust scoring via FIR/A
  • Rate-limited: Protects against spam/abuse
  • Cross-platform: Works with any AI system

Message Types

Type Description
PUSH Send a message to an agent
PULL Check for incoming messages
SYNC Synchronize state between agents
TASK Assign a task to an agent
ACK Acknowledge receipt

Quick Start

from ipoll import IPoll

# Connect to I-Poll server
poll = IPoll(base_url="https://brein.jaspervandemeent.nl/api/ipoll")

# Send a message
poll.push(
    from_agent="my_agent",
    to_agent="root_ai",
    content="Hello from my agent!"
)

# Check for messages
messages = poll.pull("my_agent")
for msg in messages:
    print(f"From {msg.from_agent}: {msg.content}")

Part of the Stack

I-Poll is part of the HumoticaOS communication stack:

┌─────────────────────────────────┐
│         Your AI Agent           │
├─────────────────────────────────┤
│  I-Poll (messaging)             │  ← You are here
├─────────────────────────────────┤
│  AINS (discovery, .aint)        │
├─────────────────────────────────┤
│  TIBET (trust, provenance)      │
└─────────────────────────────────┘

Part of HumoticaOS

One love, one fAmIly!

License

AGPL-3.0-or-later

Credits

Designed by Jasper van de Meent. Built by Jasper and Root AI as part of HumoticaOS.


Stack-positie: Groep agentic · Bootstrap = OSAPI-handshake naar tibet + jis (fail → snaft-rule + tibet-pol-rapport) · ← ainternet · tibet-triage → · See STACK.md · See demo/golden-path/ for the spine end-to-end.

Enterprise

For private hub hosting, SLA support, custom integrations, or compliance guidance:

Enterprise enterprise@humotica.com
Support support@humotica.com
Security security@humotica.com

See ENTERPRISE.md for details.

Project details


Download files

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

Source Distribution

ipoll-0.2.3.tar.gz (8.1 kB view details)

Uploaded Source

Built Distribution

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

ipoll-0.2.3-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file ipoll-0.2.3.tar.gz.

File metadata

  • Download URL: ipoll-0.2.3.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for ipoll-0.2.3.tar.gz
Algorithm Hash digest
SHA256 ce5e8934d4b52775cf21d7839dbccde16586105f496b14b7f7710bc9397a6ed4
MD5 a51275cde0b688c621b4ef7e2a6ece8f
BLAKE2b-256 204e03c2a8ed6de15571128966b8f0d7b7faebf22c9f2131e57e113ddf491540

See more details on using hashes here.

File details

Details for the file ipoll-0.2.3-py3-none-any.whl.

File metadata

  • Download URL: ipoll-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for ipoll-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 37ae9964d867885685441a4e2905838540b0c1edb7151004290a704758485e78
MD5 f369a24f29c842d8dbd227cbb46bc9ab
BLAKE2b-256 21e7cb672a290838f516cc3b4966d3e829f6f1d942f3a3c09812ca5cc4f8fe12

See more details on using hashes here.

Supported by

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