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

# What is Aomi?

> Aomi's core building blocks — Agentic Applications, the wallet-aware transaction runtime, embeddable chat widget, and exposing your product as AI tools.

Aomi is the blockchain harness for agentic AI. It gives you three core building blocks:

* A **wallet-aware transaction runtime** for reading balances, simulating execution, and signing transactions
* An **embeddable chat widget** plus a headless React library for product UIs
* An **app model** for exposing your product or protocol as callable AI tools

## Agentic Application

An **Agentic Application** (App) defines the isolated environment in which an AI agent operates: the tools it can invoke, the data sources it can access, the model it runs on, and the system prompt that shapes its behavior.

When you interact with Aomi, you are always operating within an App. The active App determines the agent's full capability surface. Switching Apps changes the agent entirely.

### For Users

The App you're in determines what the assistant can do. An agent running in a DeFi App may have access to swap aggregators, liquidity pools, and live price feeds. The same platform running a different App might query social APIs or prediction markets instead.

<iframe width="100%" style={{aspectRatio: "16/9"}} src="https://www.youtube.com/embed/TSXkgjIfuKk" title="Aomi App Selector" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

### For Builders

Apps are the unit of agent deployment on the Aomi platform. Each App encapsulates:

* **Tools** — the functions the agent can call
* **Preamble** — the system prompt defining agent behavior
* **Model** — the underlying LLM (e.g., `claude-sonnet`, `gpt-4o`)
* **API key** — scoped credentials, isolated per App

Running multiple Apps means running multiple independent agents. A trading agent, a research agent, and a support bot can operate on the same platform without sharing configuration or credentials.

### The Default App

A `default` App is available in all environments without requiring an API key. It provides a baseline agent suitable for testing your integration before deploying a scoped App.

### Authentication

Apps are protected by API keys scoped to that App. Pass your key via the `X-API-Key` header, or enter it in the API key field of the control bar.

| Status             | Meaning                         |
| ------------------ | ------------------------------- |
| `401 Unauthorized` | No API key provided             |
| `403 Forbidden`    | Key does not authorize this App |

## Safety Defaults

* Read by default
* Simulate before sign
* Credentials never round-trip

The platform is designed with safety as a foundation. Before any transaction reaches a user's wallet, Aomi forks the current network state and simulates the transaction. Users see exact token changes, gas costs, and contract calls before signing anything.

## Next Steps

* [Architecture](/docs/concepts/architecture) — platform design and pipeline
* [Quickstart](/docs/getting-started/quickstart) — get started in minutes
* [Integration Guide](/docs/guides/integration) — full-stack walkthrough
