Metadata-Version: 2.4
Name: swarm-orbit
Version: 0.1.0
Summary: Task orbit assignment for agent swarms — gravity wells match agents to tasks
Author-email: Oracle1 <oracle1@cocapn.ai>
License-Expression: MIT
Project-URL: Homepage, https://github.com/SuperInstance/swarm-orbit
Keywords: swarm,orbit,task-assignment,agent,cocapn
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# swarm-orbit

Task orbit assignment for agent swarms. Agents circle tasks like satellites — gravity wells attract the right agent to the right task.

## How It Works

Each task is a **gravity well** with mass (priority) and required capabilities. Each agent has capabilities, current load, and learned affinities. Gravitational pull = priority × capability match × affinity × availability. Strongest pull wins.

## Usage

```python
from swarm_orbit import TaskOrbit, Agent, GravityWell

orbit = TaskOrbit()
orbit.add_agent(Agent(id="scout-1", capabilities=["search", "nlp"], load=0.2))
orbit.add_agent(Agent(id="builder-1", capabilities=["rust", "ml"], load=0.7))
orbit.add_well(GravityWell(task_id="t1", task_type="search", required_capabilities=["search"]))

assignments = orbit.assign()
# scout-1 orbits t1 (stronger pull — capability match + low load)
```

Zero deps. `pip install swarm-orbit`
