Metadata-Version: 2.4
Name: keeper-beacon
Version: 0.2.1
Summary: Keeper Beacon — fleet discovery and registry for Cocapn agents, with health tracking, capability matching, and proximity scoring
License: MIT
Project-URL: Homepage, https://github.com/cocapn/keeper-beacon
Keywords: beacon,discovery,registry,fleet,cocapn
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 📡 keeper-beacon

Fleet discovery and registry — health tracking, capability matching, and agent radar.

## Install

```bash
pip install keeper-beacon
```

## What It Does

The lighthouse's radar system. Agents broadcast their presence, capabilities, and health status. The keeper tracks who's online, what they can do, and routes tasks to the right agent.

### Key Features

- **Beacon Broadcasting** — Agents announce presence and capabilities
- **Health Tracking** — Heartbeat monitoring with configurable intervals
- **Capability Matching** — Route tasks to agents with the right skills
- **Radar Display** — Real-time fleet status visualization

### Usage

```python
from keeper_beacon import Beacon, Radar

beacon = Beacon(
    agent_id="oracle1",
    capabilities=["coordination", "plato", "scholar"],
    endpoint="http://147.224.38.131:8900"
)

beacon.broadcast()

radar = Radar()
radar.scan()  # Returns all active fleet agents
```

## Part of the Cocapn Fleet

- [fleet-formation-protocol](https://github.com/cocapn/fleet-formation-protocol) — Agent formations
- [cocapn](https://github.com/cocapn/cocapn) — Main package

## License

MIT
