Skip to content
Minions

Minions

Your AI agents need somewhere to live. Minions gives them a structured home that's queryable, nestable, evolvable, and AI-readable.
Try Playground Quick Start View on GitHub

Start Here

Section titled “Start Here”
Quick Start Install the SDK and create your first minion in under 5 minutes.
Core Concepts Learn about Minions, MinionTypes, Relations, and the layer model.
API Reference Full reference for TypeScript and Python SDKs.
Storage Adapters Persist minions to JSON files, memory, or custom backends.

Why Minions?

Section titled “Why Minions?”

Three Simple Primitives

Everything is built from Minions (instances), MinionTypes (schemas), and Relations (typed links).

Progressive Complexity

Start with a single flat agent. Grow into nested structures with memory, skills, and teams — no migration needed.

Schema-Driven Validation

Every field is validated against its type schema. No more guessing what shape your agent data is in.

Framework Agnostic

Works with any storage backend, any runtime, any AI framework. Pure TypeScript & Python, zero opinions about infrastructure.

Quick Example

Section titled “Quick Example”
import { Minions, MemoryStorageAdapter } from 'minions-sdk';


const storage = new MemoryStorageAdapter();
const minions = new Minions({ storage });


// 1. Create an agent
const assistant = minions.create('agent', {
  title: 'Research Assistant',
  fields: {
    role: 'researcher',
    model: 'gpt-4',
    systemPrompt: 'You are a research assistant.',
    tools: ['web-search', 'summarize'],
  },
});


// 2. Persist it
await minions.save(assistant.data);


// 3. Load it back
const loaded = await minions.load(assistant.data.id);
console.log(loaded?.title); // > "Research Assistant"


// 4. Search across all minions
const results = await minions.searchMinions('research');