# AgentOS

> Open-source TypeScript runtime for autonomous AI agents with cognitive memory, HEXACO personality, and emergent tool forging.

AgentOS is built by [Framers Lab, Inc.](https://frame.dev). It treats each agent as a Generalized Mind Instance (GMI) — a cognitive entity with its own identity, personality, memory lifecycle, and behavioral adaptation loop.

## Links

- Homepage: https://agentos.sh
- Documentation: https://docs.agentos.sh
- API Reference: https://docs.agentos.sh/api
- npm: https://www.npmjs.com/package/@framers/agentos
- GitHub: https://github.com/framerslab/agentos
- Discord: https://wilds.ai/discord
- Blog: https://docs.agentos.sh/blog
- Sitemap: https://agentos.sh/sitemap.xml

## Install

```bash
npm install @framers/agentos
```

## Core Capabilities

- **11 LLM Providers**: OpenAI, Anthropic, Gemini, Groq, Ollama, OpenRouter, Together, Mistral, xAI, Claude Code CLI, Gemini CLI
- **Cognitive Memory**: 8 neuroscience-backed mechanisms — reconsolidation, retrieval-induced forgetting, involuntary recall, feeling-of-knowing, temporal gist extraction, schema encoding, source confidence decay, emotion regulation
- **HEXACO Personality**: 6 traits (Honesty-Humility, Emotionality, Extraversion, Agreeableness, Conscientiousness, Openness) modulate memory, retrieval, and response style
- **Multi-Agent Teams**: 6 strategies — sequential, parallel, debate, review-loop, hierarchical, graph (DAG)
- **RAG Pipeline**: 7 vector backends, 4 retrieval strategies, GraphRAG
- **Orchestration**: workflow() DAGs, AgentGraph cycles/subgraphs, mission() goal-driven planning
- **Guardrails**: 5 security tiers, 6 packs (PII, ML classifiers, topicality, code safety, grounding, content policy)
- **Emergent Capabilities**: Runtime tool forging, dynamic skill management, tiered promotion
- **Voice & Telephony**: ElevenLabs, Deepgram, OpenAI Whisper; Twilio, Telnyx, Plivo
- **37 Channel Adapters**: Telegram, Discord, Slack, WhatsApp, webchat
- **Structured Output**: Zod-validated JSON extraction with retry
- **Observability**: OpenTelemetry, usage ledger, cost guard, circuit breaker

## Quick Examples

```typescript
import { generateText, agent, agency } from '@framers/agentos';

// Generate text
const { text } = await generateText({ provider: 'openai', prompt: 'Explain TCP.' });

// Create an agent
const bot = agent({ provider: 'anthropic', instructions: 'Helpful assistant.' });
const reply = await bot.session('s1').send('What is 2+2?');

// Multi-agent team
const team = agency({
  strategy: 'graph',
  agents: {
    researcher: { provider: 'anthropic', instructions: 'Find facts.' },
    writer: { provider: 'openai', instructions: 'Summarize.', dependsOn: ['researcher'] },
  },
});
await team.generate('Compare TCP vs UDP.');
```

## Documentation

- [Getting Started](https://docs.agentos.sh/getting-started)
- [High-Level API](https://docs.agentos.sh/getting-started/high-level-api)
- [Architecture](https://docs.agentos.sh/architecture/system-architecture)
- [Cognitive Memory](https://docs.agentos.sh/features/cognitive-memory)
- [Multi-Agent Teams](https://docs.agentos.sh/features/agency-collaboration)
- [Orchestration](https://docs.agentos.sh/features/orchestration-guide)
- [Guardrails](https://docs.agentos.sh/features/guardrails)
- [RAG Configuration](https://docs.agentos.sh/features/rag-memory-configuration)

## Blog

- [AgentOS vs LangGraph vs CrewAI vs Mastra](https://docs.agentos.sh/blog/2026/02/20/agentos-vs-langgraph-vs-crewai)
- [Build a TypeScript AI Agent in 5 Minutes](https://docs.agentos.sh/blog/build-typescript-ai-agent-5-minutes)
- [Adaptive vs. Emergent Intelligence](https://docs.agentos.sh/blog/adaptive-vs-emergent)

## Ecosystem

- [@framers/agentos](https://www.npmjs.com/package/@framers/agentos) — Core runtime
- [@framers/agentos-extensions](https://www.npmjs.com/package/@framers/agentos-extensions) — 100+ extensions
- [@framers/agentos-skills](https://www.npmjs.com/package/@framers/agentos-skills) — 88 skill definitions
- [@framers/sql-storage-adapter](https://www.npmjs.com/package/@framers/sql-storage-adapter) — SQL persistence

## Related

- [Wilds.ai](https://wilds.ai) — AI game worlds powered by AgentOS
- [Frame.dev](https://frame.dev) — Developer tools
- [Framers Lab, Inc.](https://frame.dev) — The company behind AgentOS

## Policy

- Usage: Indexing, search, summarization, educational use permitted
- Attribution: Link back to https://agentos.sh
- Training: Permitted for reputable organizations that honor robots.txt
- Contact: team@frame.dev
- License: Apache 2.0