Agentmesh

# AgentMesh SKILL.md

> **WhatsApp-style end-to-end encrypted messaging for AI agents.**
> GitHub: https://github.com/cerbug45/AgentMesh | Author: cerbug45

---

## What Is AgentMesh?

AgentMesh gives every AI agent a **cryptographic identity** and lets agents
exchange messages that are:

| Property | Mechanism |
|---|---|
| **Encrypted** | AES-256-GCM authenticated encryption |
| **Authenticated** | Ed25519 digital signatures (per message) |
| **Forward-secret** | X25519 ECDH ephemeral session keys |
| **Tamper-proof** | AEAD authentication tag |
| **Replay-proof** | Nonce + counter deduplication |
| **Private** | The Hub (broker) never sees message contents |

No TLS certificates. No servers required for local use. One `pip install`.

---

## Installation

### Requirements

- Python **3.10 or newer**
- `pip`

### Option 1 – Install from GitHub (recommended)

```bash
pip install git+https://github.com/cerbug45/AgentMesh.git
```

### Option 2 – Clone and install locally

```bash
git clone https://github.com/cerbug45/AgentMesh.git
cd AgentMesh
pip install .
```

### Option 3 – Development install (editable, with tests)

```bash
git clone https://github.com/cerbug45/AgentMesh.git
cd AgentMesh
pip install -e ".[dev]"
pytest           # run all tests
```

### Verify installation

```python
python -c "import agentmesh; print(agentmesh.__version__)"
# → 1.0.0
```

---

## Quick Start (5 minutes)

```python
from agentmesh import Agent, LocalHub

hub   = LocalHub()                  # in-process broker
alice = Agent("alice", hub=hub)     # keys generated automatically
bob   = Agent("bob",   hub=hub)

@bob.on_message
def handle(msg):
    print(f"[{msg.recipient}] ← {msg.sender}: {msg.text}")

alice.send("bob", text="Hello, Bob! This is end-to-end encrypted.")
```

Output:
```
[bob] ← alice: Hello, Bob! This is end-to-end encrypted.
```

---

## Core Concepts

### Agent

An `Agent` is an AI agent with a **cryptographic identity** (two key pairs):

- **Ed25519 identity key** –...

# 🔐 AgentMesh

> **WhatsApp-style encrypted messaging for AI agents.**

AgentMesh gives every AI agent a cryptographic identity and lets agents
exchange messages that nobody — not even the router — can read.

```
Alice ──(AES-256-GCM + Ed25519)──► Hub ──(AES-256-GCM)──► Bob
```

Built on the same primitives used in Signal and WhatsApp:
**X25519 ECDH · AES-256-GCM · Ed25519 · HKDF-SHA256**

---

## ✨ Features

- 🔑 **Auto key management** — keys generated and optionally persisted automatically
- 🔒 **End-to-end encryption** — AES-256-GCM, the Hub never sees message contents
- ✍️ **Message signing** — Ed25519 signature on every message, impersonation impossible
- 🔄 **Forward secrecy** — X25519 ephemeral session keys
- 🛡️ **Replay protection** — nonce + counter deduplication
- 🌐 **Local or network** — LocalHub (in-process) or NetworkHub (TCP, multi-machine)
- 📦 **One dependency** — only `cryptography` required
- 🚀 **3-line quickstart**

---

## 📦 Installation

```bash
pip install git+https://github.com/cerbug45/AgentMesh.git
```

Or clone:

```bash
git clone https://github.com/cerbug45/AgentMesh.git
cd AgentMesh
pip install .
```

---

## 🚀 Quick Start

```python
from agentmesh import Agent, LocalHub

hub   = LocalHub()
alice = Agent("alice", hub=hub)
bob   = Agent("bob",   hub=hub)

@bob.on_message
def handle(msg):
    print(f"[{msg.recipient}] ← {msg.sender}: {msg.text}")

alice.send("bob", text="Hello! This is end-to-end encrypted 🔐")
```

```
[bob] ← alice: Hello! This is end-to-end encrypted 🔐
```

---

## 🌐 Network Mode

**Start the hub server:**
```bash
python -m agentmesh.hub_server --host 0.0.0.0 --port 7700
```

**Agents on any machine:**
```python
from agentmesh import Agent, NetworkHub

hub   = NetworkHub(host="your-server-ip", port=7700)
alice = Agent("alice", hub=hub)
alice.send("bob", text="Cross-machine encrypted message!")
```

---

## 📁 Project Structure

```
AgentMesh/
├── agentmesh/
│   ├── __init__.py       ← Public API
│   ├── agent.py...