Welcome to Cogitator

What is Cogitator?Copy Anchor Link

Cogitator is a self-hosted, production-grade AI agent runtime for TypeScript. It provides everything you need to build, orchestrate, and deploy autonomous AI agents — from simple chat assistants to multi-agent swarms with memory, tools, workflows, and sandboxed code execution.

Key FeaturesCopy Anchor Link

• Multi-Model Support — Ollama, OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, vLLM, Mistral, Groq, Together and DeepSeek, plus your own backends
• Agent Framework — type-safe tools, structured outputs, reasoning, handoffs, tool approvals with pause/resume, vision & audio
• Swarm Intelligence — 7 coordination strategies (hierarchical, round-robin, consensus, auction, pipeline, debate, negotiation)
• Workflow Engine — DAG-based orchestration with sagas, human-in-the-loop approvals, timers, scheduling and checkpoints
• Memory & RAG — Redis, Postgres, SQLite, MongoDB, Qdrant and in-memory adapters, hybrid BM25 + vector search, knowledge graphs, a RAG pipeline
• Channels & Voice — Telegram, Discord, Slack, WhatsApp and WebChat gateways; STT/TTS and realtime voice agents
• Server Adapters — Express, Fastify, Hono, Koa, Tetsu and Next.js, with OpenAPI generation
• Sandboxed Execution — Docker and WASM sandboxes for running untrusted code
• Protocols — Model Context Protocol (client and server) and Agent-to-Agent (A2A)
• Observability & Evals — Langfuse and OpenTelemetry exporters, per-run cost tracking, an eval framework

Quick StartCopy Anchor Link

Scaffold a project:

npx create-cogitator-app my-agent
cd my-agent
npm run dev

Or install manually:

npm install @cogitator-ai/core zod

import { Cogitator, Agent, tool } from '@cogitator-ai/core';
import { z } from 'zod';

const cogitator = new Cogitator({
  llm: {
    providers: {
      ollama: { baseUrl: 'http://localhost:11434' },
    },
  },
});

const agent = new Agent({
  name: 'assistant',
  model: 'ollama/llama3.2',
  instructions: 'You are a helpful assistant.',
  tools: [
    tool({
      name: 'greet',
      description: 'Greet someone',
      parameters: z.object({ name: z.string() }),
      execute: async ({ name }) => `Hello, ${name}!`,
    }),
  ],
});

const result = await cogitator.run(agent, { input: 'Say hello to the world' });
console.log(result.output);

await cogitator.close();

Continue with the Quick Start guide.