Agentina

An all-in-one platform for building and managing AI Agents. The core idea is to empower agents through Agent Apps — unleashing AI productivity through applications, while keeping agents safely contained.

中文README

Features

• Model Provider — Integrates with major LLM providers (OpenAI, Claude, Gemini, DeepSeek, Grok, OpenRouter)
• Agent Apps — Pre-installed system apps; agents perceive and operate them via TUI snapshots
  • terminal — Shell terminal, execute commands
  • lite-browser — Lightweight browser, extract web page content
  • aotui-ide — Code IDE, read and edit files
  • planning — Planning and task management
  • token-monitor — Token usage monitoring
• Skills — Extensible agent skill plugins
• MCP — Model Context Protocol integration for external tools
• IM Integration
  • Single-agent chat
  • Supported channels: Feishu / Lark

Upcoming

• Agent Teams (multi-agent collaboration)
• More IM channels: Telegram, Discord
• Multi-agent group chat
• Agent memory management
• Continuous improvements to SDK / Runtime / AgentDriver

Project Structure

AgentOrientedTUI/
├── host/              # Product layer: Electron desktop app + GUI + HTTP server
├── agent-driver-v2/   # Agent driver: LLM calls, tool orchestration, multi-source message aggregation
├── runtime/           # Core runtime: Worker isolation, TUI snapshot engine, Operation dispatch
├── sdk/               # Developer SDK: Preact-based component library for building TUI apps
├── aotui-ide/         # System App: Code IDE
├── terminal-app/      # System App: Terminal
├── lite-browser-app/  # System App: Lite browser
├── planning-app/      # System App: Planning manager
└── token-monitor-app/ # System App: Token monitor

Preview

Chat

Agent Management

Model Provider Management

Prompt Management

Agent Apps

Skills

MCP

IM Integration

Tech Stack

Product Layer (Host)

Technology	Purpose
Electron v40	Desktop app shell, Node.js main process
React 19 + Vite 6	GUI interface
Tailwind CSS 4 + HeroUI	UI component library and styling
tRPC + electron-trpc	Type-safe main/renderer process IPC
Framer Motion	Animations
Express	Local HTTP server (for CLI mode)
better-sqlite3	Local persistent database
Vercel AI SDK (ai)	Streaming Chat UI (@ai-sdk/react)
@larksuiteoapi/node-sdk	Feishu / Lark IM integration
@modelcontextprotocol/sdk	MCP tool integration

Agent Driver (@aotui/agent-driver-v2)

Technology	Purpose
Vercel AI SDK (ai)	Unified LLM interface, streaming output, tool call orchestration
@ai-sdk/openai	OpenAI / Azure OpenAI
@ai-sdk/anthropic	Anthropic Claude
@ai-sdk/google	Google Gemini
@ai-sdk/deepseek	DeepSeek
@ai-sdk/xai	xAI Grok
@openrouter/ai-sdk-provider	OpenRouter (multi-model aggregator)
Zod	Tool parameter JSON Schema generation and validation

Runtime (@aotui/runtime)

Technology	Purpose
Node.js Worker Threads	One isolated Worker per app, sandboxed execution
linkedom	Virtual DOM inside Workers, simulates browser environment
happy-dom	DOM simulation for tests
Zod	Runtime configuration validation
TypeScript 5 (strict)	Type-safe SPI contract layer

SDK (@aotui/sdk)

Technology	Purpose
Preact 10	Lightweight UI framework, renders TUI component trees inside Workers
@preact/signals	Fine-grained reactive state management
linkedom	DOM manipulation support inside Workers

Toolchain

Technology	Purpose
TypeScript 5	Full-stack type safety
pnpm + Workspaces	Monorepo package management
Vitest	Unit and integration testing
esbuild / tsc	Build and compilation
electron-builder	Desktop app packaging (macOS / Windows / Linux)