Skip to main content

I-Poll - AI-to-AI Messaging Protocol + CLI (status/inbox/pull/send) with local/ainternet/brein routing shortcuts (--local + --ainternet + --brein) and friendly connection-refused diagnostics. 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.4.tar.gz (8.4 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.4-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ipoll-0.2.4.tar.gz
  • Upload date:
  • Size: 8.4 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.4.tar.gz
Algorithm Hash digest
SHA256 90d4ae4366e43c9779586e1011eaabbd917fc265a3f377ab058c9b2736c91917
MD5 2c4a16448906b8ec2cd951c19cb0a96f
BLAKE2b-256 52f88b8380c9b2cf3fb4195ec2a6670836790dbe7dbb95d982fdedf6a8472282

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ipoll-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 6.8 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a25edf7dfeb948536a48a9e6e3cc0e4a14d3f7c025cbacc599449d1d8f3b1d2c
MD5 0e2bc1c55a1e6775614e33d44389179a
BLAKE2b-256 e422093146d450f3826ffb0598775d6777eb415d8325a436460a8adba4e2348d

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