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 the curated tool, integration, voice, productivity, cloud, domain and channel extensions with a single createCuratedManifest() call; the research packs (citation-verifier, trulia-search) load when tools names them. Handles lazy loading, secret resolution, and factory invocation.
npm install @framers/agentos-extensions-registry
import { AgentOS } from '@framers/agentos';
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 = await AgentOS.create({ extensionManifest: manifest });
In an npm install, only the extension packages that are installed load: a missing package is skipped, and the registry logs a warning when the call names it.
@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
Curated extensions (more than 100 manifests under registry/curated/), by category, with examples:
| Category | Examples |
|---|---|
| Research | web-search, web-browser, web-scraper, news-search, deep-research, citation-verifier |
| Media | giphy, image-search, voice-synthesis, omdb |
| Voice | streaming-stt-deepgram, streaming-stt-whisper, google-cloud-tts, piper |
| System | cli-executor, browser-automation, credential-vault |
| Integrations | telegram, github, clearbit |
| Provenance | anchor-providers |
| Safety | pii-redaction, ml-classifiers, topicality, code-safety, grounding-guard, content-policy-rewriter |
| Channels | 37 adapters: telegram, whatsapp, discord, slack, webchat, email, sms and the rest |
The other categories are auth, cloud, communications, domains, memory, productivity and tools.
@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) lives in @framers/agentos/cognition/skills.
@framers/agentos/cognition/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
RunArtifactschema atparacosm/schemacovering 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:
WorldModel.replay()reruns the kernel's between-turn transitions from the snapshots a run recorded withcaptureSnapshots: true, makes no model calls, and reports whether the current kernel reproduces those snapshots byte for byte. The director writes each turn's events from a prompt that carries the leader's HEXACO profile and the run's accumulated state; a compiled scenario's founding event on turn 1 and legacy event on its last turn are written once, when the scenario compiles, and are the same for every leader SubjectConfigandInterventionConfiginput primitives for digital-twin adoption
🌐 Live demo: paracosm.agentos.sh/sim · Docs: paracosm.agentos.sh/docs
agentos.sh
Marketing Site and Documentation Hub — The AgentOS website. The official documentation is docs.agentos.sh, built from agentos-live-docs; agentos.sh/docs redirects there.
🌐 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)
Quick Links
| Resource | Link |
|---|---|
| Documentation | agentos.sh/docs |
| API Reference | docs.agentos.sh/api |
| npm | @framers/agentos |
| Discord | Join Community |
| @framerslab |
Contributing
We welcome contributions to any repository in the ecosystem:
- Bug reports — Open an issue
- Feature requests — Open an issue with the Feature request form
- Extensions — Submit to agentos-extensions
- Documentation — PRs welcome on any repo