# Installation

Umbraco.AI is distributed as NuGet packages. You need to install the core package and at least one provider package.

## Install the Core Package

Add the Umbraco.AI package to your Umbraco project:

{% code title="Package Manager Console" %}

```powershell
Install-Package Umbraco.AI
```

{% endcode %}

Or using the .NET CLI:

{% code title=".NET CLI" %}

```bash
dotnet add package Umbraco.AI
```

{% endcode %}

## Install a Provider Package

Umbraco.AI requires at least one provider to connect to AI services. Install the provider for your preferred AI service.

### OpenAI

{% code title=".NET CLI" %}

```bash
dotnet add package Umbraco.AI.OpenAI
```

{% endcode %}

{% hint style="info" %}
Additional providers will be available in future releases. You can also create custom providers for other AI services.
{% endhint %}

## Package Contents

The packages install the following components:

| Package             | Contents                                                              |
| ------------------- | --------------------------------------------------------------------- |
| `Umbraco.AI`        | Core services, backoffice UI, Management API, database migrations     |
| `Umbraco.AI.OpenAI` | OpenAI provider with chat, embedding, and speech-to-text capabilities |

## Verify Installation

After installation, build your project:

{% code title=".NET CLI" %}

```bash
dotnet build
```

{% endcode %}

When you run your Umbraco site, a new **AI** section will appear in the backoffice.

![The AI section in the Umbraco backoffice main navigation](/files/jKjXd04jETrGqBjuMrfH)

{% hint style="info" %}
**User Permissions**: The AI section is a standalone section in the backoffice. You may need to grant your user group access to the AI section:

1. Navigate to **Users** > **User Groups**
2. Edit the relevant user group (for example, Administrators)
3. Enable **AI** in the **Sections** list
4. Save the user group
5. Refresh your browser to see the AI section
   {% endhint %}

![User Groups edit screen showing AI section access](/files/DZLuDGKj9AUnfB343cRX)

## Next Steps

{% content-ref url="/pages/IHczmv3f3ZbKUxPClNqO" %}
[The First Connection](/ai-in-umbraco/getting-started/first-connection.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/ai-in-umbraco/getting-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.