> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Deploy agents to Slack with streaming responses.

The Slack interface turns any Agno agent, team, or workflow into an interactive Slack app with streaming task cards, suggested prompts, and thread-based sessions.

## Quick Start

```python slack_agent.py theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.os.app import AgentOS
from agno.os.interfaces.slack import Slack

agent = Agent(name="Assistant", model=OpenAIResponses(id="gpt-5.4"))

agent_os = AgentOS(
    agents=[agent],
    interfaces=[Slack(agent=agent)],
)
app = agent_os.get_app()
```

```bash theme={null}
uv pip install 'agno[slack]'
python -m agno.os.serve slack_agent:app --port 7777
```

## How It Works

| Concept       | Behavior                                                     |
| ------------- | ------------------------------------------------------------ |
| **Threads**   | Each Slack thread is a separate session with its own history |
| **Streaming** | Responses stream as live task cards with tool calls visible  |
| **@mentions** | By default, responds to @mentions in channels and all DMs    |
| **Files**     | Users can send files; agents can upload responses            |

## Setup

Requires a Slack App with OAuth scopes and event subscriptions. See the [setup guide](/agent-os/interfaces/slack/setup) for step-by-step instructions.

**Environment variables:**

```bash theme={null}
export SLACK_TOKEN="xoxb-..."
export SLACK_SIGNING_SECRET="..."
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Full Guide" icon="book" href="/agent-os/interfaces/slack/introduction">
    Sessions, files, SlackTools, multi-instance, and troubleshooting.
  </Card>

  <Card title="Reference" icon="square-sliders" href="/agent-os/interfaces/slack/reference">
    All parameters, scopes, endpoints, and events.
  </Card>

  <Card title="Examples" icon="code" href="/agent-os/usage/interfaces/slack/basic">
    14 examples: teams, workflows, streaming, multimodal.
  </Card>

  <Card title="SlackTools" icon="wrench" href="/tools/toolkits/social/slack">
    Give agents messaging, search, and file capabilities.
  </Card>
</CardGroup>