> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bastani.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Libraries

> The TypeScript libraries Atomic is built on, published as @bastani/atomic-* packages you can use in extensions, SDK apps, or on their own.

Atomic is built on six TypeScript libraries. Each one is published on npm at Atomic's version with every release, and each works on its own outside Atomic.

| Package | What it does |
| - | - |
| [`@bastani/atomic-ai`](https://docs.bastani.ai/libraries/ai) | One API for every LLM provider: models, auth, streaming, tools, images, classification and thinking |
| [`@bastani/atomic-agent-core`](https://docs.bastani.ai/libraries/agent-core) | A stateful agent loop with tool execution, event streaming, steering and follow-up messages |
| [`@bastani/atomic-tui`](https://docs.bastani.ai/libraries/tui) | A terminal UI framework with differential rendering, components, overlays and key handling |
| [`@bastani/atomic-codemode`](https://docs.bastani.ai/libraries/codemode) | A sandbox that runs model-written JavaScript whose only capability is calling the tools you give it |
| [`@bastani/atomic-schema`](https://docs.bastani.ai/libraries/schema) | JSON Schema builders and validation without `eval` |
| [`@bastani/atomic-telemetry`](https://docs.bastani.ai/libraries/telemetry) | Vendor-neutral telemetry contracts and reference contexts; it sends nothing on its own |

## Install

Install a library on its own with npm:

```bash theme={null}
npm install @bastani/atomic-ai
```

Inside an Atomic [extension](https://docs.bastani.ai/extensions.md), import the libraries without installing them: the running Atomic provides them, so your extension shares its instances. If you publish an [Atomic package](https://docs.bastani.ai/packages/authoring.md) that imports them, list them in `peerDependencies` with a `"*"` range.

To build on Atomic's sessions, tools and extensions rather than the bare libraries, use the [SDK](https://docs.bastani.ai/sdk.md) instead. For custom extension UI, start with [TUI components](https://docs.bastani.ai/tui.md).

## Older package names

These libraries began as forks of pi's packages. Extensions written for pi keep working in Atomic: imports of `@earendil-works/pi-ai`, `@earendil-works/pi-tui`, `@earendil-works/pi-agent-core`, `@earendil-works/pi-codemode`, `@earendil-works/pi-schema`, `@earendil-works/pi-telemetry`, their `@mariozechner/pi-*` equivalents, and `@bastani/pi-ai`, including their subpaths, resolve to the matching `@bastani/atomic-*` package. Use the `@bastani/atomic-*` names in new code. The old names only resolve inside Atomic; outside it, install the `@bastani/atomic-*` packages.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.