In your .env

<p align="center">

```
 ____                  _     _
|  _ \ _ __ _____   _(_)___(_) ___  _ __
| |_) | '__/ _ \ \ / / / __| |/ _ \| '_ \
|  __/| | | (_) \ V /| \__ \ | (_) | | | |
|_|   |_|  \___/ \_/ |_|___/_|\___/|_| |_|
```

</p>

<p align="center">
  Open-source platform for deploying AI agents that work like employees.
</p>

<p align="center">
  <a href="#quick-start">Quick Start</a> &middot;
  <a href="#features">Features</a> &middot;
  <a href="https://provision.ai">Website</a> &middot;
  <a href="https://docs.provision.ai">Docs</a> &middot;
  <a href="https://discord.gg/W8rnGcvRCu">Discord</a>
</p>

<p align="center">
  <a href="https://github.com/provision-org/provision-core/stargazers"><img src="https://img.shields.io/github/stars/provision-org/provision-core?style=social" alt="GitHub Stars" /></a>
  &nbsp;
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
  &nbsp;
  <a href="https://discord.gg/W8rnGcvRCu"><img src="https://img.shields.io/badge/Discord-Join%20us-5865F2?logo=discord&logoColor=white" alt="Discord" /></a>
  &nbsp;
  <a href="https://github.com/provision-org/provision-core/actions/workflows/tests.yml"><img src="https://github.com/provision-org/provision-core/actions/workflows/tests.yml/badge.svg" alt="Tests" /></a>
</p>

---

## What is Provision

Provision lets you deploy AI agents that work for your company. Start simple with **chat agents** that join your Slack, Telegram, Discord, or web chat and respond to messages like any other team member. Or go further with **task agents** that work autonomously from a kanban board, organized in an org chart with managers, goals, and human approval gates. Everything is open source, self-hostable with Docker, and extensible through a plugin architecture. No vendor lock-in — run it on your own infrastructure or use [Provision Cloud](https://provision.ai) for managed hosting.

## Screenshots

<table>
  <tr>
    <td align="center">
      <img src="docs/screenshots/task-board.png" alt="Task board with kanban columns" width="400" />
      <br /><em>Task board with kanban columns</em>
    </td>
    <td align="center">
      <img src="docs/screenshots/org-chart.png" alt="Org chart with reporting hierarchy" width="400" />
      <br /><em>Org chart with reporting hierarchy</em>
    </td>
  </tr>
  <tr>
    <td align="center">
      <img src="docs/screenshots/goals.png" alt="Goal hierarchy with progress tracking" width="400" />
      <br /><em>Goal hierarchy with progress tracking</em>
    </td>
    <td align="center">
      <img src="docs/screenshots/approvals.png" alt="Approval inbox for agent decisions" width="400" />
      <br /><em>Approval inbox for agent decisions</em>
    </td>
  </tr>
</table>

## Quick Start

**Prerequisites:** [Docker Desktop](https://www.docker.com/products/docker-desktop/) installed and running.

```bash
git clone https://github.com/provision-org/provision-core.git && cd provision-core
cp .env.example .env
```

Add your OpenRouter key to `.env` (see [Configuration](#configuration) below), then:

```bash
docker compose up -d         # ~2 min on first run
```

Open **http://localhost:8000** &rarr; create an account &rarr; create a team &rarr; deploy your first agent.

<details>
<summary><strong>Run without Docker</strong> (PHP 8.3+, Node 22+, Redis)</summary>

```bash
composer install && npm install
cp .env.example .env
php artisan key:generate && php artisan migrate
php artisan db:seed --class=AgentTemplateSeeder
php artisan db:seed --class=TeamPackSeeder
composer run dev
```

You'll need Redis running locally for queues, cache, and sessions.

</details>

## Task Agents vs Chat Agents

Provision agents operate in one of two modes. You can mix both in the same team.

### Chat Agents

Chat agents live in your messaging channels. Connect one to **Slack**, **Telegram**, **Discord**, or the built-in **web chat** and it responds to messages, participates in threads, and can be mentioned like any colleague. Each agent gets its own Chrome browser, email identity, and workspace files.

**Best for:** customer support, Q&A, knowledge work, team communication.

```
User  →  Slack / Telegram / Discord / Web Chat
      →  Agent receives message
      →  Agent responds in thread
```

### Task Agents

Task agents work from the **task board** without waiting for a conversation. You create tasks, assign them to agents, and they execute autonomously. Agents are organized in an **org chart** with managers and direct reports. They pursue **goals** with measurable progress. High-stakes actions go through **approval gates** before executing.

**Best for:** engineering, research, operations, and anything that doesn't need a human in the loop.

```
User  →  Task Board (create task, assign agent)
      →  provisiond picks up task on agent server
      →  Agent executes autonomously
      →  Reports result back to Provision
```

### When to Use Which

| Scenario | Mode | Why |
|----------|------|----

... (truncated)