> For the complete documentation index, see [llms.txt](https://docs.katara.ai/about/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.katara.ai/about/brains/create.md).

# Create a Brain

Create a Brain when you need a dedicated set of directly uploaded sources and the knowledge derived from them. You do not need a Q\&A alias merely to create the Brain or read its Wiki later.

## Before you start

* Sign in and select the intended organization. Complete any organization or subscription setup required by the application.
* Make sure **Create Brain** is available to your account.
* Decide whether this is personal knowledge or a shared team resource. The **Personal** or **Team** choice is permanent.
* For a Team Brain, decide which users or groups should view or contribute. The creator becomes the owner; adding an Editor does not transfer ownership.

See the [Brain overview](https://docs.katara.ai/about/brains/overview.md) for access and availability basics.

## Create the Brain

1. Open **Brains** from the sidebar and select **Create Brain**.
2. Check the organization shown in the creation sheet.
3. Enter **Name**. It must contain at least two characters after trimming surrounding whitespace.
4. Optionally enter a description. Leave it empty or provide at least two trimmed characters.
5. Choose **Personal** or **Team** explicitly.
   * **Personal** has no Brain audience grants.
   * **Team** lets you select organization users or groups and assign **Viewer** or **Editor** access. Leaving the audience empty creates an owner-only Team Brain.
6. Review the audience and submit the form.
7. Open the resulting Brain and check initialization before uploading.

A successful creation response identifies the new Brain, but initialization can still be pending. Do not treat the first receipt as confirmation that uploads, refreshes or answering are ready. Creating a Brain also does not enable GitHub export.

## Add the first content

Once the Brain is ready and enabled, open **Sources → Upload sources**. Choose files to upload directly to it. Existing documents in Content Management cannot be attached as Brain sources; collection membership does not make a document part of a Brain.

After upload acceptance, follow [Sources](https://docs.katara.ai/about/brains/sources.md) and [Activity](https://docs.katara.ai/about/brains/activity.md) to distinguish ingestion from a completed Wiki refresh. An empty Knowledge page immediately after creation is not evidence that creation failed.

For answering and contributions, create or select an enabled [Q\&A agent](https://docs.katara.ai/about/agents-and-answering/qna.md) whose answer source is this Brain. Contribution tools require explicit alias validation. A Brain's own identifier is not a substitute for the Q\&A agent identifier.

## If something goes wrong

**Create Brain is missing or creation is unavailable:** check organization access and the [availability guidance](https://docs.katara.ai/about/reference/availability.md). Creation depends on service readiness as well as your permissions.

**A name or description is rejected:** remove accidental whitespace and check the minimum length. An optional description may be completely empty.

**Creation returned an uncertain result:** check the Brains list before submitting another creation. Search covers only the loaded page, so use pagination. Do not assume a missing confirmation means nothing was created.

**Initialization remains pending:** wait for a confirmed ready state; repeatedly attempting uploads will not initialize the Brain. Ask your administrator to investigate persistent initialization failures.

**You chose the wrong kind:** it cannot be converted. Create the appropriate Brain instead and upload the intended sources there. Use [Settings](https://docs.katara.ai/about/brains/settings.md) to manage the original Brain and review deletion consequences before removing it.
