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…

Что это такое?Agent-Native — это фреймворк с открытым исходным кодом на TypeScript для создания приложений с ИИ-агентами: каждая возможность описывается один раз как «действие» (action), которое ИИ-агент может вызвать как инструмент, а интерфейс — напрямую из кода. Данные, права доступа и состояние используются обеими сторонами совместно.
Это фреймворк для разработки или готовое приложение?Это фреймворк для создания собственных приложений с ИИ-агентами. В репозитории также есть несколько примеров агентов с открытым исходным кодом (Clips, Design, Slides, Analytics, Calendar, Mail, Assets, Content, Plans), созданных на его основе, с которых можно начать.
Как начать работать с Agent-Native?Установите зависимости через pnpm (pnpm install), следуйте руководству по началу работы, затем опишите возможность в файле вроде actions/hello.ts и вызывайте её из React с помощью хука useActionQuery.
Какой бэкенд нужен, чтобы всё это запустить?Для workspace нужны Node.js 22.22+ и pnpm, а в продакшене — PostgreSQL (для локальной разработки — PGlite) на любом хостинге, совместимом с Nitro. Свою LLM вы подключаете сами.
Нужно ли привязываться к конкретной LLM или хостинг-провайдеру?Нет, фреймворк не привязан к конкретной инфраструктуре: свою LLM, SQL-базу данных, инструменты и инфраструктуру вы выбираете сами, и всё, что вы создаёте, остаётся вашим.
Что именно такое «shared action» в Agent-Native?Общее действие — это возможность, которая описывается в коде один раз (например, actions/hello.ts). Агент вызывает её как инструмент, а интерфейс — напрямую через хук вроде useActionQuery. При этом используются одни и те же проверки и права доступа.
Как ещё можно обратиться к действию, кроме интерфейса на React?Agent-Native также открывает каждое действие через HTTP, MCP, A2A и CLI, поэтому одна и та же логика работает с разными клиентами и протоколами агентов.
Что входит, кроме самой системы действий?Чат с агентами, аутентификация и права доступа, навыки и память, автоматизации по расписанию и по событиям, многоагентные «команды агентов» и бэкенд на PostgreSQL/PGlite.
Можно ли попробовать, не создавая своего агента?Да, есть галерея готовых агентов с открытым исходным кодом (Clips, Design, Slides, Analytics, Calendar, Mail, Assets, Content, Plans), которых можно запустить или использовать как шаблоны.
Creator
BuilderIO
Size
497.1 MB
Stars
7.4K
Age
7mo
Commits · 90 Days