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

# What is AgentArea

# What is AgentArea

AgentArea runs AI agents under controls you configure: which tools an agent may
call, whose data it may read, what it may spend, and what a human has to approve
before it proceeds. Agents execute in isolated sandboxes on durable workflows,
and every decision is recorded.

It is open core and Apache-2.0 licensed. You can self-host the whole thing.

## The problem it addresses

Getting one agent to work is a weekend. Running agents where the cost of a
mistake is real is a different problem, and it is mostly not a modelling problem:

* An agent acts with someone's authority. Which someone, and how far does it
  extend?
* Model output is untrusted input. It arrives as a shell command or a tool call.
* Agents are long-running and stateful. A process crash mid-task should not lose
  the task.
* When something goes wrong, someone will ask what happened and why it was
  allowed.

Most agent frameworks treat these as deployment concerns left to the reader.
AgentArea treats them as the product, which is why it looks less like a library
and more like infrastructure.

## What it gives you

**Isolation by construction.** Every entity belongs to a workspace, and
repositories cannot be built without a user context. Scoping is structurally hard
to omit rather than a rule developers must remember.

**Relationship-based authorization.** Permissions come from relationships in a
graph — this user manages this project, this project contains this agent —
evaluated by OpenFGA or Ory Keto. Checks fail closed.

**Sandboxed execution.** Commands and skills run in isolated sandboxes managed by
a dedicated Go service, not in the workflow process. Logs and artifacts go to
object storage and are referenced by handle.

**Durable workflows.** Agent execution is a Temporal workflow. A worker restart
does not lose a task, and a run can wait on a human approval for as long as it
takes without holding a connection open.

**Governed tool access.** Tool calls pass an interceptor pipeline — budget gates,
security filters, observers — before they run, and the same policy that decides
what an agent may call decides what it is even shown.

**MCP as the tool interface.** External tools connect over the Model Context
Protocol, hosted by AgentArea or connected remotely, with secrets resolved
server-side.

## How the pieces fit

```mermaid theme={null}
graph TB
    subgraph Control["Control plane"]
        API[FastAPI API]
        WORKER[Temporal worker]
        AUTHZ[OpenFGA / Keto]
        PG[(PostgreSQL)]
    end

    subgraph Data["Data plane"]
        MGR[MCP manager, Go]
        SBX[Sandbox sessions]
        MCPI[MCP server instances]
        OBJ[(Object storage)]
    end

    UI[Web dashboard] --> API
    CLI[CLI / A2A clients] --> API
    API --> AUTHZ
    API --> PG
    API --> WORKER
    WORKER --> MGR
    MGR --> SBX
    MGR --> MCPI
    SBX --> OBJ
```

The split matters: the control plane decides and records, the data plane executes
and holds payload. That boundary is what lets execution move into your own
network while the platform stays where it is. [How it works](/how-it-works)
follows a single request across it.

## The stack

| Layer                         | Technology               |
| ----------------------------- | ------------------------ |
| Frontend                      | Next.js 16, React 19     |
| API                           | FastAPI, Python 3.12+    |
| Workflows                     | Temporal 1.29            |
| Sandbox and MCP orchestration | Go, Kubernetes or Docker |
| Database                      | PostgreSQL 18            |
| Cache and streams             | Valkey 8                 |
| Object storage                | RustFS, S3-compatible    |
| Authorization                 | OpenFGA or Ory Keto      |
| Identity                      | Ory Kratos, Hydra        |

## Why not an agent framework?

If you are building one agent, or embedding agent behaviour into an existing
service, a framework is the right tool and this is too much machinery.

The trade happens when agents start acting on behalf of other people. A framework
gives you the loop and leaves isolation, authorization, durability, and audit as
integration work — which is where the effort actually goes, and where getting it
subtly wrong is expensive. AgentArea makes those the platform's job, at the cost
of being something you operate: four processes, a database, a workflow engine,
and an authorization service.

That cost is only worth paying if the governance is worth something to you. If
it is not, use a framework.

## Limits

Worth knowing before you invest time.

* **Not a model-agnostic agent framework you embed.** AgentArea is a platform you
  deploy. If you want a library to import into an existing service, this is more
  than you need.
* **Not a hosted product you can sign up for today.** The documented path is
  self-hosting.
* **Not finished.** Parts of the network model are descriptive rather than
  enforced, and the concept pages say which. Where documentation and code
  disagree, the code is right and the page is a bug.

## Where to go next

Start here, in order:

1. [Getting started](/getting-started) — `make up-dev` to a running dashboard.
2. [How it works](/how-it-works) — the request path, and what each service does.
   Read this before the rest of the documentation; it makes the rest legible.
3. [Building agents](/building-agents) — create an agent, give it a model, run a
   task.

Then, depending on what you are evaluating:

* [Agentic networks](/concepts/agentic-networks) — the network model, and which
  parts of it are enforced
* [Workspaces, projects, and resources](/concepts/workspaces-projects-resources) —
  the scoping model everything else assumes
* [Control plane and data plane](/concepts/control-and-data-plane) — where your
  data goes, and how to keep it in your network
* [Open core](/concepts/open-core) — what is core, what is commercial, and how
  the boundary is implemented
* [Deployment](/deployment) — running it somewhere other than your laptop

## License and community

Apache License 2.0. Commercial features exist as a separately installed package;
see [Open core](/concepts/open-core) for exactly where the line falls.

* [GitHub](https://github.com/agentarea/agentarea)
* [Discord](https://discord.gg/5tduPwheYQ)
