Open source · MIT License

Operating system
for AI agents.

Six production-ready primitives — filesystem, database, memory, network, processes, and events — secured and isolated per agent.

6 primitives · 5 minutes · production ready▋

Start building free →Star on GitHub

primitives

90d

token TTL

MIT

license

agent.ts

1// All 6 primitives in one agent
3import { AgentOS } from '@agentos/sdk';
5const os = new AgentOS({ apiKey });
7// net — fetch live BTC price
8const p = await os.net.http_get(btcUrl);
10// mem — cache for 60s
11await os.mem.set('btc', p.price, 60);
13// db — persist history
14await os.db.insert('prices', row);
16// proc — run analysis
17const sig = await os.proc.execute(py, 'python');
19// events — broadcast signal
20await os.events.publish('signals', sig);
22// fs — save report
23await os.fs.write('report.json', result);

The problem

Stop reinventing infrastructure

Every agent team rebuilds the same boilerplate. Agent OS ships it once.

Before Agent OS

before.ts

typescript

// Before Agent OS
const redis = new Redis(process.env.REDIS_URL);
const supabase = createClient(url, key);
const { exec } = require('child_process');

// Set up auth, rate limiting, sandboxing...
// Handle errors, timeouts, quotas...
// Write 500+ lines of infra code
// before a single line of agent logic.

With Agent OS

after.ts

typescript

// With Agent OS
const os = new AgentOS({ apiKey: process.env.AGENT_OS_KEY });

await os.mem.set('key', value);
await os.db.insert('table', row);
await os.proc.execute(code, 'python');
// Auth, isolation, quotas — included.

Primitives

6 primitives, infinite possibilities

Everything an agent needs to read, write, compute, and communicate.

os.mem

Memory

Redis-backed key-value store with TTL, namespaced per agent.

mem_setmem_getmem_deletemem_listmem_incr

os.fs

Filesystem

Cloud file storage backed by Supabase. Each agent gets isolated storage.

fs_readfs_writefs_listfs_deletefs_mkdir

os.db

Database

PostgreSQL with per-agent schema isolation. Queries, transactions, DDL.

db_querydb_insertdb_updatedb_deletedb_transaction

os.net

Network

Outbound HTTP with SSRF protection, domain allowlisting, rate limiting.

net_http_getnet_http_postnet_http_putnet_dns_resolve

os.proc

Process

Sandboxed code execution: Python, JavaScript, Bash. Timeouts & quotas.

proc_executeproc_scheduleproc_spawnproc_kill

os.events

Events

Redis pub/sub messaging. Publish, subscribe, coordinate across agents.

events_publishevents_subscribeevents_list_topics

Live example

See all 6 in 40 lines

A trading agent that monitors BTC and broadcasts buy signals.

trading-agent.ts

typescript

import { AgentOS } from '@agentos/sdk';

const os = new AgentOS({
  apiUrl: 'https://agentos-app.vercel.app',
  apiKey: process.env.AGENT_OS_KEY
});

// Monitor Bitcoin price
const price = await os.net.http_get(
  'https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT'
);

// Cache for 60 seconds
await os.mem.set('btc_price', price.data.price, 60);

// Store in database
await os.db.insert('prices', {
  symbol: 'BTC',
  price: parseFloat(price.data.price),
  timestamp: Date.now()
});

// Run analysis
const signal = await os.proc.execute(`
import numpy as np
prices = ${JSON.stringify(priceHistory)}
rsi = calculate_rsi(prices)
print('BUY' if rsi < 30 else 'HOLD')
`, 'python');

// Publish event
if (signal.output === 'BUY') {
  await os.events.publish('trading.signals', {
    symbol: 'BTC',
    action: 'BUY',
    price: price.data.price
  });
}

Use cases