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.
Get Started View on GitHub

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, zero opinions about infrastructure.

Quick Example

Section titled “Quick Example”

Choose between the unified Minions client for seamless access or the modular functions for absolute control.

Unified Client

Section titled “Unified Client”
import { Minions, InMemoryStorage } from 'minions-sdk';


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


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


// 2. Query it
const result = await minions.get(assistant.id);

OR Modular Imports

import { createMinion, InMemoryStorage } from 'minions-sdk';


const storage = new InMemoryStorage();


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


// 2. Save it
await storage.saveMinion(assistant);