minions-sdk 0.2.0

Python SDK for the Minions structured object system

minions-sdk (Python)

Python SDK for the Minions structured object system — queryable, nestable, evolvable, and AI-readable.

Install

pip install minions-sdk

Quick Start

from minions import TypeRegistry, create_minion, RelationGraph

# 1. Get the built-in agent type
registry = TypeRegistry()
agent_type = registry.get_by_slug("agent")

# 2. Create an agent
minion, validation = create_minion(
    {"title": "Research Assistant", "fields": {"role": "researcher", "model": "gpt-4"}},
    agent_type,
)

# 3. Link minions together
graph = RelationGraph()
graph.add({"source_id": minion.id, "target_id": "skill-001", "type": "parent_of"})

Cross-SDK Interop

Minions created in Python can be serialized to JSON and read by the TypeScript SDK:

import json
data = minion.to_dict()          # camelCase keys
json_str = json.dumps(data)      # → valid JSON, TS-compatible

Documentation

• 📘 Docs
• 📄 Specification v0.1

License

MIT