# guiasdelcodigo/xolo-bot architecture

> Architecture diagram of the GitHub repository guiasdelcodigo/xolo-bot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/guiasdelcodigo/xolo-bot
- Repository: https://github.com/guiasdelcodigo/xolo-bot

## Overview

XoloBot is a Discord community bot. Its runtime entry point loads the bot, which registers command cogs and syncs slash commands; users can then invoke greetings and music controls. Music searches YouTube, maintains per-server queues, and plays audio through FFmpeg. The README also documents moderation, vacancy scraping, and GitHub notifications, but their implementations are not present in the supplied tree, so those branches are shown only at the documented capability level.

Main entry points: [`services/core/app/bot.py`](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/bot.py) (XoloBot), [`services/core/app/cogs/music.py`](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py) (Music commands), [`services/core/app/cogs`](https://github.com/guiasdelcodigo/xolo-bot/tree/main/services/core/app/cogs) (GitHub notifications), [`services/core/app/cogs/greeting.py`](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/greeting.py) (Greeting commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot runtime"]
  node_entry["Application entry<br/>[main.py]"]
  node_bot["XoloBot<br/>[bot.py]"]
end

subgraph group_commands["Bot capabilities"]
  node_greeting["Greeting commands<br/>[greeting.py]"]
  node_moderation["Moderation"]
  node_vacancies["Vacancy scraper"]
  node_github["GitHub notifications"]
end

subgraph group_music["Music playback"]
  node_music_commands["Music commands<br/>[music.py]"]
  node_track_search["Track search<br/>[music.py]"]
  node_track_queue[("Per-server queue<br/>[music.py]")]
  node_audio_playback["Audio playback<br/>[music.py]"]
end

node_user(("Discord user"))
node_discord["Discord"]
node_youtube["YouTube"]
node_ffmpeg["FFmpeg"]

node_entry -->|"creates"| node_bot
node_bot -->|"loads"| node_greeting
node_bot -->|"loads"| node_music_commands
node_user -->|"invokes"| node_greeting
node_user -->|"invokes"| node_music_commands
node_music_commands -->|"searches"| node_track_search
node_track_search -->|"queries"| node_youtube
node_music_commands -->|"updates"| node_track_queue
node_music_commands -->|"starts playback"| node_audio_playback
node_audio_playback -->|"dequeues"| node_track_queue
node_audio_playback -->|"plays through"| node_ffmpeg
node_bot -->|"provides"| node_moderation
node_bot -->|"provides"| node_vacancies
node_bot -->|"provides"| node_github
node_github -->|"notifies"| node_discord

click node_entry "https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/main.py"
click node_bot "https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/bot.py"
click node_greeting "https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/greeting.py"
click node_moderation "https://github.com/guiasdelcodigo/xolo-bot/tree/main/services/core/app/cogs"
click node_vacancies "https://github.com/guiasdelcodigo/xolo-bot/tree/main/services/core/app/cogs"
click node_github "https://github.com/guiasdelcodigo/xolo-bot/tree/main/services/core/app/cogs"
click node_music_commands "https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py"
click node_track_search "https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py"
click node_track_queue "https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py"
click node_audio_playback "https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_bot,node_user toneBlue
class node_greeting,node_moderation,node_vacancies,node_github toneAmber
class node_music_commands,node_track_search,node_track_queue,node_audio_playback toneMint
class node_discord,node_youtube,node_ffmpeg toneIndigo
```

## Components

### Bot runtime

- [Application entry](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/main.py): `services/core/app/main.py`
- [XoloBot](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/bot.py): `services/core/app/bot.py`

### Bot capabilities

- [Greeting commands](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/greeting.py): `services/core/app/cogs/greeting.py`
- [Moderation](https://github.com/guiasdelcodigo/xolo-bot/tree/main/services/core/app/cogs): `services/core/app/cogs`
- [Vacancy scraper](https://github.com/guiasdelcodigo/xolo-bot/tree/main/services/core/app/cogs): `services/core/app/cogs`
- [GitHub notifications](https://github.com/guiasdelcodigo/xolo-bot/tree/main/services/core/app/cogs): `services/core/app/cogs`

### Music playback

- [Music commands](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py): `services/core/app/cogs/music.py`
- [Track search](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py): `services/core/app/cogs/music.py`
- [Per-server queue](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py): `services/core/app/cogs/music.py`
- [Audio playback](https://github.com/guiasdelcodigo/xolo-bot/blob/main/services/core/app/cogs/music.py): `services/core/app/cogs/music.py`

### Other components

- **Discord user**
- **Discord**
- **YouTube**
- **FFmpeg**

## Connections

- Application entry → XoloBot: creates (evidence: `services/core/app/main.py`)
- XoloBot → Greeting commands: loads (evidence: `services/core/app/bot.py`)
- XoloBot → Music commands: loads (evidence: `services/core/app/bot.py`)
- Discord user → Greeting commands: invokes (evidence: `services/core/app/cogs/greeting.py`)
- Discord user → Music commands: invokes (evidence: `services/core/app/cogs/music.py`)
- Music commands → Track search: searches (evidence: `services/core/app/cogs/music.py`)
- Track search → YouTube: queries (evidence: `services/core/app/cogs/music.py`)
- Music commands → Per-server queue: updates (evidence: `services/core/app/cogs/music.py`)
- Music commands → Audio playback: starts playback (evidence: `services/core/app/cogs/music.py`)
- Audio playback → Per-server queue: dequeues (evidence: `services/core/app/cogs/music.py`)
- Audio playback → FFmpeg: plays through (evidence: `services/core/app/cogs/music.py`)
- XoloBot → Moderation: provides (evidence: `README.md`)
- XoloBot → Vacancy scraper: provides (evidence: `README.md`)
- XoloBot → GitHub notifications: provides (evidence: `README.md`)
- GitHub notifications → Discord: notifies (evidence: `README.md`)
