# Overview

Configure, deploy, and talk to your first agent in a few minutes.





This quickstart walks you through the full end-to-end flow against the Nairi API:

1. Create an agent and attach a rule and a vault.
2. Deploy the agent so it starts answering prompts.
3. Start a conversation, wait for the reply, and send a follow-up.

Every step shows the equivalent code in **bash**, **TypeScript**, **Ruby**, **Python**, and **Go**, so you can drop the snippets straight into whatever you're building.

## Prerequisites [#prerequisites]

* A Nairi organization with an API key. Generate one from your organization's settings in the [Nairi dashboard](https://app.nairi.ai).

* The API key exported as `NAIRI_API_KEY` in your shell or process environment:

  ```bash
  export NAIRI_API_KEY=your-key-here
  ```

* For the **bash** flow you'll also need [`curl`](https://curl.se) and [`jq`](https://jqlang.github.io/jq/) installed locally.

<Callout type="warn">
  Treat API keys like passwords. Never commit them to source control. If a key is compromised, revoke it from the dashboard.
</Callout>

## Base URL [#base-url]

All endpoints below are served from:

```text
https://api.nairi.ai/api/public/v1
```

## Walkthrough [#walkthrough]

<Cards>
  <Card title="1. Configure and deploy an agent" href="/api/quickstart/configure-and-deploy" description="Create the agent, attach a rule and a vault, then deploy it." />

  <Card title="2. Drive a conversation" href="/api/quickstart/drive-a-conversation" description="Start a conversation, poll for the reply, and send a follow-up." />

  <Card title="3. Full example" href="/api/quickstart/full-example" description="The whole flow as one script, in every supported language." />
</Cards>