agent-native README

The project's README from github.com/BuilderIO/agent-native. As one markdown file: README.md.

Agent-Native: The agentic application framework

Agent-Native

Agent-Native is an open-source TypeScript framework for building agents that pair autonomous work with a purpose-built UI. Define each capability once as an action: the agent uses it as a tool, and the UI calls it from code.

Quick start

npx @agent-native/core@latest create my-agent --standalone --template chat

Follow the getting started guide for a full intro to the framework.

Why build agents with UIs?

Coding agents work with more than a text box. Their environment provides context, tools, files, tests, and previews that make their capabilities and results visible.

Knowledge work needs that same kind of environment. A UI shows what an agent can do and gives people familiar ways to inspect, edit, approve, and share its work.

How Agent-Native works

The agent does not click through the UI. It works through the same action layer as the UI.

Example: a shared action

Create actions/hello.ts:

import { defineAction } from "@agent-native/core/action";
import { z } from "zod";

export default defineAction({
  description: "Return a friendly greeting.",
  schema: z.object({
    name: z.string().default("world").describe("Name to greet"),
  }),
  http: { method: "GET" },
  run: async ({ name }) => {
    return { message: `Hello, ${name}!` };
  },
});

The agent receives hello as a tool. React calls the same function with useActionQuery("hello", { name: "Alex" }). Agent-Native also exposes it through HTTP, MCP, A2A, and the CLI.

Included

Bring your LLM, SQL database, tools, and infrastructure. Everything you build stays yours.

See Agent-Native in action:

https://github.com/user-attachments/assets/ef51644b-6506-46d8-8083-0af7b7e5b65c


Open-source agents

Start from one of these agents or use it as an example for your own.



Clips

Clips app screenshot

Record and understand meetings, screens, and voice notes.

Design

Design app screenshot

Generate and refine interactive designs.

Slides

Slides app screenshot

Create and edit on-brand presentations.

Analytics

Analytics app screenshot

Ask questions of your data and build dashboards.

Calendar

Calendar app screenshot

Find time, schedule events, and manage bookings.

Mail

Mail app screenshot

Prioritize email, draft replies, and follow up.

Assets

Assets app screenshot

Create and organize on-brand media.

Content

Content app screenshot

Draft, organize, and publish content.

Plans

Plans app screenshot

Create and review visual plans with diagrams, wireframes, and prototypes.

Explore the full app gallery, or start with the framework guide.

Documentation and community

Contributing

Working on this repository itself? See DEVELOPMENT.md for local setup, workspace structure, and guard scripts.

License

MIT

agent-native (BuilderIO/agent-native)

Searching Database…

7.4K ·GitHub
Agent-native
这是什么?Agent-Native 是一个开源的 TypeScript 框架,用于构建智能体(agentic)应用:每项能力只需定义一次,定义为一个 'action'。AI 智能体可以把它当作工具调用,界面也可以在代码中直接调用它,两者共享数据、权限和状态。
这是用来搭建应用的框架,还是现成的应用?这是用来搭建你自己的智能体应用的框架。仓库中还附带了几个基于它构建的开源示例智能体(Clips、Design、Slides、Analytics、Calendar、Mail、Assets、Content、Plans),你可以从它们开始。
我该如何开始使用 Agent-Native 进行开发?用 pnpm 安装(pnpm install),按照入门指南操作,然后在类似 actions/hello.ts 的文件中定义一项能力,并在 React 中使用 useActionQuery hook 调用它。
运行它需要什么后端?工作区需要 Node.js 22.22+ 和 pnpm;生产环境需要 PostgreSQL(本地开发使用 PGlite),可部署在任何兼容 Nitro 的主机上;大语言模型需要你自行提供。
我是否必须绑定某个特定的大语言模型或托管服务商?不必。它与基础设施无关:大语言模型、SQL 数据库、工具和基础设施都由你自行选择,你构建的所有内容都归你所有。
Agent-Native 中的“共享 action”到底是什么?action 是在代码中只定义一次的一项能力(例如 actions/hello.ts)。智能体将其作为工具调用,界面则通过 useActionQuery 等 hook 直接调用,两者共享相同的校验和权限规则。
除了 React 界面,还能通过什么方式调用 action?Agent-Native 还会通过 HTTP、MCP、A2A 和 CLI 暴露每一个 action,因此同样的逻辑可以在不同的客户端和智能体协议之间通用。
除了 action 系统本身,还包含哪些内容?智能体聊天、身份验证和权限、技能与记忆、定时或事件触发的自动化、多智能体的“智能体团队”,以及 PostgreSQL/PGlite 后端。
我能不先自己构建智能体就试用它吗?可以。有一个画廊,里面是现成的开源智能体(Clips、Design、Slides、Analytics、Calendar、Mail、Assets、Content、Plans),你可以直接运行,也可以把它们当作模板使用。
What are similar projects?OpenIntelligentUI, Agentlas-OS, CopilotKit, OpenDots, hermes-workspace, hive, voltagent, spring-ai-alibaba
Which topics is it in?agent-native, agent-ui, a2a, agent-framework, memory, authentication, agentic-ai, postgresql, multi-agent, agents, agent-skills, ai-agent
Creator
BuilderIO
Size
497.1 MB
Stars
7.4K
Updated
CommitOct 17Releasev0.1.283Oct 16
Age
7mo
Commits · 90 Days