# @assistant-ui/core

> Framework-agnostic core runtime for assistant-ui

Latest version **0.3.26** (published 2026-10-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @assistant-ui/core
pnpm add @assistant-ui/core
yarn add @assistant-ui/core
bun add @assistant-ui/core
```

## Health

**Score 60/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score; popular repo.

Warnings: low downloads; no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.3.26 |
| Published | 2026-10-10 |
| First published | 2026-02-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 12192 |
| Author | AgentbaseAI Inc. |
| Maintainers | yonom, okisdev, agentbase-bot |
| Keywords | assistant, ai, chat, runtime, framework-agnostic |

## Links

- npm: https://www.npmjs.com/package/@assistant-ui/core
- Repository: https://github.com/assistant-ui/assistant-ui
- Homepage: https://www.assistant-ui.com/
- Issues: https://github.com/assistant-ui/assistant-ui/issues
- npm.io page: https://npm.io/package/@assistant-ui/core

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 0.3.26 (latest) — 2026-10-10
- 0.3.25 — 2026-10-09
- 0.3.24 — 2026-10-06
- 0.3.23 — 2026-10-06
- 0.3.22 — 2026-10-02
- 0.3.21 — 2026-09-24
- 0.3.20 — 2026-09-18
- 0.3.19 — 2026-09-15
- 0.3.18 — 2026-09-11
- 0.3.17 — 2026-09-03
- 0.3.16 — 2026-08-27
- 0.3.15 — 2026-08-20
- 0.3.14 — 2026-08-18
- 0.3.13 — 2026-08-12
- 0.3.12 — 2026-08-09
- … 50 more at https://npm.io/package/@assistant-ui/core/versions

## README

# `@assistant-ui/core`

[![npm version](https://img.shields.io/npm/v/@assistant-ui/core)](https://www.npmjs.com/package/@assistant-ui/core)
[![GitHub stars](https://img.shields.io/github/stars/assistant-ui/assistant-ui)](https://github.com/assistant-ui/assistant-ui)

The framework-agnostic core of assistant-ui. Defines the shared types, runtime interfaces, adapter contracts, and React bindings that the distribution packages re-export.

Most users do not install `@assistant-ui/core` directly. Reach for the distribution that matches your target:

| Distribution                  | Use this for          |
| ----------------------------- | --------------------- |
| `@assistant-ui/react`         | Web applications.     |
| `@assistant-ui/react-native`  | React Native apps.    |
| `@assistant-ui/react-ink`     | Terminal/Ink apps.    |

`core` is published so that integration libraries (for example `@assistant-ui/react-ag-ui`) can depend on the runtime types without pulling in DOM or native primitives.

## Installation

```bash
npm install @assistant-ui/core
```

## Usage

```ts
import { tool, ModelContextRegistry } from "@assistant-ui/core";
import { z } from "zod";

const registry = new ModelContextRegistry();

registry.addTool({
  toolName: "getWeather",
  ...tool({
    parameters: z.object({ city: z.string() }),
    execute: async ({ city }) => fetchWeather(city),
  }),
});
```

## Sub-paths

`@assistant-ui/core` exposes `.`, `./react`, `./store`, and `./internal` sub-paths. The `./react` sub-path holds the React hooks and providers consumed by `@assistant-ui/react` and `@assistant-ui/react-native`.

Full reference for message types, runtime interfaces, and adapter contracts at [assistant-ui.com/docs/architecture](https://www.assistant-ui.com/docs/architecture).

---
_Source: https://npm.io/package/@assistant-ui/core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._