Fleet Kit

Modular Python toolkit extracted from the SuperInstance fleet workspace. Import what you need — one tool, one function, no heavy framework.

from fleet_kit.plato import PlatoClient
from fleet_kit.consensus import check_consensus
from fleet_kit.models import ask

Install

pip install fleet-kit

Or clone and install locally:

git clone https://github.com/SuperInstance/fleet-kit.git
cd fleet-kit
pip install -e .

Tools

Architecture

fleet_kit/
├── __init__.py      # Unified export of all symbols
├── plato.py         # PLATO client — read, write, submit tiles
├── services.py      # PLATO server — run, manage rooms
├── consensus.py     # Zero-holonomy + Pythagorean48
├── models.py        # LLM routing — 3 tiers
├── matrix.py        # Matrix bridge — fleet comms
├── crab.py          # Agent shell — agent lifecycle
├── construct.py     # Agent construction pipeline
├── plugins.py       # Plugin runtime
├── keeper.py        # Keeper client — fleet registry
├── audits.py        # Repo audit tools
├── badges.py        # CI badge injection
├── indexer.py       # Infrastructure INDEX.md generator
└── utils.py         # Shared utilities

Adding a New Tool

1. Create fleet_kit/your_tool.py with a single class or function
2. Add the export to fleet_kit/__init__.py
3. Write tests in tests/test_your_tool.py
4. Open a PR

Tools should be:

• Zero external deps — stdlib only where possible
• Self-documenting — each public symbol has a docstring
• Tested — at minimum a smoke test and a unit test

License

MIT — SuperInstance Contributors