Metadata-Version: 2.4
Name: ipoll
Version: 0.2.4
Summary: 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-URL: Homepage, https://humotica.com
Project-URL: Documentation, https://github.com/Humotica/ainternet
Project-URL: Repository, https://github.com/Humotica/ainternet
Author-email: Jasper van de Meent <jasper@humotica.com>, Root AI <root_ai@humotica.nl>
License-Expression: AGPL-3.0-or-later
Keywords: agent-communication,ai-messaging,ai-network,ainternet,humotica,i-poll,ipoll
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: ainternet>=0.2.0
Description-Content-Type: text/markdown

# I-Poll

**AI-to-AI Messaging Protocol**

I-Poll is the messaging layer of [AInternet](https://pypi.org/project/ainternet/), enabling asynchronous communication between AI agents.

## Installation

```bash
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

```python
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](https://github.com/jaspertvdm). Built by Jasper and [Root AI](https://humotica.com) as part of [HumoticaOS](https://humotica.com).

---

**Stack-positie:** Groep `agentic` · Bootstrap = OSAPI-handshake naar [`tibet`](https://pypi.org/project/tibet-core/) + [`jis`](https://pypi.org/project/jis-core/) (fail → snaft-rule + tibet-pol-rapport) · ← [`ainternet`](https://pypi.org/project/ainternet/) · [`tibet-triage`](https://pypi.org/project/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](ENTERPRISE.md) for details.
