# Discord

Deploy AI agents on Discord using Aivara’s modular templates. Automate messages, integrate AI models, and build smarter bots with minimal setup.

Aivara simplifies building and deploying AI agents for **Discord**. These templates provide a full-stack, modular solution to automate responses, moderate chats, and enhance community interaction with AI.

Whether you want to deploy a basic chatbot, automate repetitive tasks, or integrate advanced AI models, this guide will show you how to set up a fully functional AI agent using Aivara.

***

**Step 1: Installation and Setup**

Start by installing Aivara and its dependencies:

Copy

Copy

Copy

```
bashCopy code# Install Aivara
pip install aivara

# Install Discord API wrapper (discord.py)
pip install discord.py

# Install any AI provider SDK (e.g., OpenAI)
pip install openai
```

***

**Step 2: Set Up Your Discord Bot**

1. Go to the Discord Developer Portal.
2. Create a new application and navigate to the **Bot** tab.
3. Add a bot, copy the **token**, and save it securely.
4. Invite your bot to a server using the OAuth2 URL Generator (scope: `bot`, permissions: `Send Messages`).

***

**Step 3: Complete Discord AI Agent Code**

Here’s a **fully modular** example that listens to messages, processes them using **OpenAI's GPT-4**, and sends intelligent responses back to the same Discord channel.

***

**Full Discord Agent Code**

Copy

Copy

Copy

```
pythonCopy codeimport discord
from aivara import InputBlock, ProcessingBlock, OutputBlock
import asyncio

# Discord Bot Token
DISCORD_TOKEN = "YOUR_DISCORD_BOT_TOKEN"
CHANNEL_ID = 1234567890  # Replace with your Discord channel ID

# Initialize Discord Client
intents = discord.Intents.default()
intents.messages = True
client = discord.Client(intents=intents)

# Aivara Workflow Blocks
class DiscordAgent:
    def __init__(self):
        self.input_block = InputBlock("discord", token=DISCORD_TOKEN, channel_id=CHANNEL_ID)
        self.processing_block = ProcessingBlock("openai", model="gpt-4", api_key="YOUR_OPENAI_API_KEY")
        self.output_block = OutputBlock("discord_response", token=DISCORD_TOKEN)

    async def process_message(self, message_content):
        # Connect the Aivara blocks for input, processing, and output
        print(f"Processing message: {message_content}")

        # Input Block: Capture the message
        self.input_block.data = {"prompt": message_content}

        # Processing Block: Send the message to OpenAI's GPT-4
        response = self.processing_block.process()

        # Output Block: Send response back to Discord
        await self.output_block.send(response)

# Event: On Message
@client.event
async def on_ready():
    print(f"We have logged in as {client.user}")

@client.event
async def on_message(message):
    if message.author == client.user:
        return

    # Initialize Aivara agent and process message
    agent = DiscordAgent()
    await agent.process_message(message.content)
    await message.channel.send("Thinking... 🤖")

# Run the Discord Bot
client.run(DISCORD_TOKEN)
```

***

**Step 4: Explanation of Code**

1. **InputBlock**: Captures messages from the Discord channel.
2. **ProcessingBlock**: Uses OpenAI’s GPT-4 to process the message and generate a response.
3. **OutputBlock**: Sends the AI-generated response back to the Discord channel.
4. **Discord Events**: Listens to incoming messages (`on_message`) and triggers Aivara workflows.

***

**Step 5: Run the Bot**

Save the script as `discord_ai_agent.py` and run it:

Copy

Copy

Copy

```
bashCopy codepython discord_ai_agent.py
```

You should see a message like: `We have logged in as YOUR_BOT_NAME`

Now type something in your Discord channel, and the bot will respond intelligently using GPT-4 or the selected AI provider.

***

**Extending the Template**

Here are a few ideas for extending this template:

1. **Moderation Tool** Filter out harmful messages and send alerts to moderators.

Copy

Copy

Copy

```
pythonCopy code# Replace ProcessingBlock with moderation logic
self.processing_block = ProcessingBlock("openai", model="gpt-4", prompt="Filter harmful content: {message}")
```

1. **Contextual Chatbot** Store chat history in a vector store like Pinecone for better context-aware replies.

Copy

Copy

Copy

```
pythonCopy codefrom aivara import ProcessingBlock

vector_block = ProcessingBlock("pinecone", api_key="YOUR_PINECONE_API_KEY", index_name="chat_history")
self.processing_block >> vector_block
```

1. **Scheduled Announcements** Automate reminders and updates in Discord at scheduled times.

Copy

Copy

Copy

```
pythonCopy codeawait self.output_block.send("Daily update: Don't forget to check Aivara's new templates!", schedule="daily 9:00 AM")
```

***

**Use Cases for Discord Templates**

* **Community Bots**: AI-powered bots to answer FAQs, moderate content, or provide announcements.
* **Task Automation**: Automate repetitive tasks, like scheduling reminders or pulling data.
* **Interactive Chatbots**: Intelligent agents that provide natural, AI-driven responses to user queries.
* **Gaming and Utility Bots**: Create tools for gaming stats, updates, and integrations.

***

**Conclusion**

With Aivara’s Discord templates, building AI-powered bots is fast, efficient, and fully customizable. Whether you’re automating tasks, improving user interactions, or deploying advanced AI tools, Aivara’s modular workflows give you everything you need to get started.