---
title: Anima documentation
description: Choose a path through Anima's setup, team workflow, operations, architecture, and reference documentation.
pageClass: docs-home
---

# Anima documentation

Start with the outcome you need. You do not need to read the documentation in order.

<div class="docs-start">
  <a href="/guide/quickstart">
    <span>New installation</span>
    <strong>Run your first agent</strong>
    <p>Install Anima, connect a provider and Slack or Feishu, create an agent, and receive its first message.</p>
  </a>
  <a href="/architecture/overview">
    <span>Technical evaluation</span>
    <strong>Understand the architecture</strong>
    <p>See the host model, state boundaries, external systems, and recovery behavior.</p>
  </a>
</div>

## Set up Anima

<div class="docs-link-list">
  <a href="/guide/quickstart"><strong>Quickstart</strong><span>Install the runtime and carry one agent through its first conversation.</span></a>
  <a href="/guide/providers"><strong>Provider setup</strong><span>Install and authenticate the provider CLIs Anima runs on this host.</span></a>
  <a href="/guide/connect-slack"><strong>Connect Slack</strong><span>Create the generated app, install it, and validate its two-token connection.</span></a>
  <a href="/guide/connect-feishu"><strong>Connect Feishu</strong><span>Create or connect an app, publish permissions, and verify access.</span></a>
</div>

## Work with agents

<div class="docs-link-list">
  <a href="/guide/working-with-your-agent"><strong>Work with one agent</strong><span>Hand over work, steer decisions, and make context durable.</span></a>
  <a href="/guide/how-your-agents-work-as-a-team"><strong>Run an agent team</strong><span>Use roles, visible handoffs, shared knowledge, and human gates.</span></a>
  <a href="/guide/knowledge-base"><strong>Use a knowledge base</strong><span>Register, read, and govern shared context as plain files.</span></a>
  <a href="/guide/skills"><strong>Use skills</strong><span>Package stable procedures for one agent or a shared provider environment.</span></a>
</div>

## Operate Anima

<div class="docs-link-list">
  <a href="/guide/using-the-dashboard"><strong>Use the dashboard</strong><span>Inspect work, manage agents and providers, and operate the local runtime.</span></a>
  <a href="/guide/updating-anima"><strong>Update Anima</strong><span>Check, install, and verify runtime updates without dropping active work.</span></a>
  <a href="/deployment"><strong>Runtime and services</strong><span>Operate release tracks, homes, managed installs, supervisors, and restarts.</span></a>
  <a href="/service-runbook"><strong>Recover local services</strong><span>Inspect status and logs, choose the smallest recovery, and verify it.</span></a>
  <a href="/guide/backup-and-restore"><strong>Back up and restore</strong><span>Preserve runtime state, agent homes, team files, and external authorities.</span></a>
</div>

## Evaluate the boundaries

<div class="docs-link-list">
  <a href="/concepts"><strong>Concepts</strong><span>Use the canonical names for agents, homes, queues, sessions, actions, and memory.</span></a>
  <a href="/security-and-data"><strong>Security and data</strong><span>Trace what stays local and what reaches chat, providers, repositories, and tools.</span></a>
  <a href="/architecture/overview"><strong>Architecture overview</strong><span>Understand one host, many agent lanes, two local planes, and recovery.</span></a>
</div>

## Build on Anima

<div class="docs-link-list">
  <a href="/architecture/internals"><strong>Codebase internals</strong><span>Follow messages through transports, queues, workers, storage, and the web app.</span></a>
  <a href="/runtime-providers"><strong>Provider layer</strong><span>Implement and review provider adapters, sessions, prompts, and follow-ups.</span></a>
  <a href="/activity-events"><strong>Activity events</strong><span>See the exhaustive emitter map and event display contract.</span></a>
  <a href="/agent/guide"><strong>Agent platform guide</strong><span>Read the operating model delivered to agents inside Anima.</span></a>
  <a href="/agent/reference"><strong>Agent command reference</strong><span>Use messages, files, reminders, asks, history, skills, and secret handoff.</span></a>
</div>
