Skip to main content

Ecosystem

Related repositories, packages, and resources for building with AgentOS.

Core Packages​

@framers/agentos​

Main SDK — The core orchestration runtime for building adaptive AI agents.

npm install @framers/agentos

@framers/sql-storage-adapter​

SQL Storage — Cross-platform SQL storage abstraction with automatic fallbacks. Supports SQLite, PostgreSQL, and in-memory storage.

npm install @framers/sql-storage-adapter

Features:

  • SQLite (better-sqlite3, sql.js for browser)
  • PostgreSQL (pg)
  • Automatic runtime detection
  • Vector storage support for RAG

@framers/agentos-extensions-registry​

Curated Extensions Registry — Load all official extensions with a single createCuratedManifest() call. Handles lazy loading, secret resolution, and factory invocation.

npm install @framers/agentos-extensions-registry
import { createCuratedManifest } from '@framers/agentos-extensions-registry';

const manifest = await createCuratedManifest({
  tools: 'all',
  channels: 'none',
  secrets: { 'serper.apiKey': process.env.SERPER_API_KEY! },
});

const agentos = new AgentOS();
await agentos.initialize({ extensionManifest: manifest });

Only installed extension packages will load — missing ones are skipped silently.

@framers/agentos-extensions​

Extension Source — Implementations, templates, and manifests for tools, channel adapters, and integrations. The agentos-extensions-registry package catalogs and loads these.

npm install @framers/agentos-extensions

Available Extensions:

CategoryExtensions
Researchweb-search, web-browser, news-search
Mediagiphy, image-search, speech-runtime, voice-synthesis
Systemcli-executor, auth
Integrationstelegram, telegram-bot
Provenanceanchor-providers, tip-ingestion
Channelstelegram, whatsapp, discord, slack, webchat

@framers/agentos-skills-registry​

Curated Skills Catalog SDK — typed catalog (SKILLS_CATALOG), query helpers, and lazy-loading factories for SkillRegistry and snapshots.

npm install @framers/agentos-skills-registry
// Lightweight catalog queries (zero peer deps)
import { searchSkills, getSkillsByCategory } from '@framers/agentos-skills-registry/catalog';

// Full registry with lazy-loaded @framers/agentos
import { createCuratedSkillSnapshot } from '@framers/agentos-skills-registry';
const snapshot = await createCuratedSkillSnapshot({ skills: ['github', 'weather'] });

@framers/agentos-skills​

Skills Content — 88 curated SKILL.md prompt modules + registry.json index.

npm install @framers/agentos-skills

This is the content package for skills. The runtime engine (SkillLoader, SkillRegistry, path utilities) now lives in @framers/agentos/skills.

@framers/agentos/skills               <- Engine (SkillLoader, SkillRegistry, path utils)
@framers/agentos-skills               <- Content (88 SKILL.md files + registry.json)
@framers/agentos-skills-registry      <- Catalog SDK (SKILLS_CATALOG, query helpers, factories)

Applications​

Paracosm​

AI Agent Swarm Simulation Engine — Define worlds as JSON, assign AI leaders with HEXACO personality profiles, and watch their decisions compound into measurably different outcomes from identical starting conditions. Built on @framers/agentos.

npm install paracosm

Features:

  • Universal RunArtifact schema at paracosm/schema covering turn-loop civilization sims, batch-trajectory digital twins, and batch-point forecasts
  • HEXACO personality-driven commander decisions with runtime tool forging through AgentOS's EmergentCapabilityEngine
  • Deterministic kernel + LLM Event Director: same leader on the same seed replays byte-for-byte; two different leaders on the same seed get divergent events from turn 1 (the director reads each leader's HEXACO + accumulated state)
  • SubjectConfig and InterventionConfig input primitives for digital-twin adoption

🌐 Live demo: paracosm.agentos.sh/sim · Docs: paracosm.agentos.sh/docs

agentos.sh​

Documentation Website — Official documentation and marketing site.

🌐 Live: agentos.sh

agentos-workbench​

Development Workbench — Visual development environment for building and testing AgentOS agents.

Features:

  • Interactive agent playground
  • Tool testing interface
  • Conversation history viewer
  • Real-time streaming visualization

Wunderland​

Autonomous Agent Network + SDK — A social network layer for agents (identity, tips, governance) plus a TypeScript SDK built on AgentOS.

npm install wunderland

Docs: https://docs.wunderland.sh
Rabbit Hole (control plane): https://rabbithole.inc (self-hosted runtime by default; managed runtime is enterprise)

ResourceLink
Documentationagentos.sh/docs
API Referencedocs.agentos.sh/api
npm@framers/agentos
DiscordJoin Community
Twitter@framersai

Contributing​

We welcome contributions to any repository in the ecosystem:

  1. Bug reports — Open an issue
  2. Feature requests — Start a discussion
  3. Extensions — Submit to agentos-extensions
  4. Documentation — PRs welcome on any repo

Architecture Overview​

┌─────────────────────────────────────────────────────────────┐
│                      Your Application                        │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    @framers/agentos                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   AgentOS   │  │     GMI     │  │   Tool Orchestrator │  │
│  │   Runtime   │  │   Manager   │  │                     │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
          │                   │                    │
          ▼                   ▼                    ▼
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│ sql-storage-    │  │    agentos-     │  │   LLM Providers │
│ adapter         │  │    extensions   │  │  (OpenAI, etc.) │
└─────────────────┘  └─────────────────┘  └─────────────────┘