The Autonomous Community Engine & AI Companion for Developer Guilds
Self-hosted. Low-latency. Zero telemetry. Built for OpenWinter.
v1.0.1-release β’ Python 3.11+ β’ Discord Gateway v10 β’ MIT Licensed β’ Docker Ready
Website Β· Architecture Β· Feature Matrix Β· Contributor Cards Β· Quickstart Β· Configuration Β· Documentation Β· Contributing
SirDeep is an open-source, asynchronous community infrastructure bot engineered specifically for software development guilds, open-source organizations, and technical teams.
Unlike bloated, multi-purpose bots loaded with invasive analytics, SirDeep operates on a zero-telemetry, zero-trust security model. It consolidates autonomous moderation logging, anti-nuke staff quarantine, hybrid local/cloud AI pair programming, continuous 24/7 lo-fi radio, and dynamic PIL glassmorphic rank card generation into a unified, lightweight Python core.
SirDeep includes a dedicated set of custom developer emojis designed for modern Discord guilds:
:sirdeep_cool: |
:sirdeep_coding: |
:sirdeep_idea: |
:sirdeep_voice: |
:sirdeep_verified: |
:sirdeep_coffee: |
:sirdeep_hype: |
:sirdeep_goated: |
|---|---|---|---|---|---|---|---|
SirDeep includes a built-in graphics compositor that generates high-definition contributor profile cards directly in Python without headless browsers or external rendering APIs:
- Level 1 β 4:
BUILDER(Initial community onboarding) - Level 5 β 14:
CORE CONTRIBUTOR(Consistent technical contributions) - Level 15+:
SENIOR ARCHITECT(Architectural leadership & mentorship)
flowchart TD
subgraph Discord Gateway
GW[Discord WebSocket Gateway v10]
end
subgraph SirDeep Core
BOT[SirDeepBot Async Client]
GW -->|Events| BOT
subgraph Subsystems
SEC[Security & Anti-Nuke Sentinel]
AUD[Audit Logger Engine]
AI[Hybrid AI Inference Engine]
RAD[24/7 Radio Streamer]
LVL[Leveling & PIL Cards]
DEB[Daily Dilemma Scheduler]
end
BOT --> SEC
BOT --> AUD
BOT --> AI
BOT --> RAD
BOT --> LVL
BOT --> DEB
end
subgraph Backends & Transcoders
OLLAMA[(Local Ollama Instance)]
OPENROUTER[(Cloud AI APIs)]
FFMPEG[[FFmpeg Audio Demuxer]]
CDN[(Discord CDN)]
end
AI -.->|Local HTTP| OLLAMA
AI -.->|HTTPS API| OPENROUTER
RAD -.->|Stream Pipe| FFMPEG
LVL -.->|Avatar Fetch| CDN
Deploy SirDeep in an isolated Linux container with pre-bundled FFmpeg and TrueType fonts:
# 1. Clone repository
git clone https://github.com/opensourcewinter/sirdeep.git
cd sirdeep
# 2. Configure credentials
cp .env.example .env
cp config/config.example.yaml config/config.yaml
# 3. Launch in detached mode
docker compose up -d --build
# 4. View live logs
docker compose logs -fPrerequisites: Python 3.11+ and ffmpeg installed on your system PATH.
# 1. Clone & enter project
git clone https://github.com/opensourcewinter/sirdeep.git
cd sirdeep
# 2. Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# 3. Install production dependencies
pip install -r requirements.txt
# 4. Configure environment
cp .env.example .env
cp config/config.example.yaml config/config.yaml
# 5. Start SirDeep
python main.py| Variable | Description | Example / Default |
|---|---|---|
DISCORD_BOT_TOKEN |
Discord Bot Token from Developer Portal | Required |
DISCORD_GUILD_ID |
Primary server Snowflake ID | 123456789012345678 |
AI_PROVIDER |
Active AI backend (openrouter, ollama, gemini, openai) |
openrouter |
OPENROUTER_API_KEY |
OpenRouter API Key | Optional |
OLLAMA_BASE_URL |
Local Ollama endpoint | http://localhost:11434 |
FFMPEG_PATH |
Custom FFmpeg binary path override | (Auto-detects from PATH) |
ENVIRONMENT |
Running mode (production or development) |
production |
Important
To enable real-time audit event capturing, member welcome generation, and interactive chat, you must enable Privileged Gateway Intents in the Discord Developer Portal:
- Go to Applications
$\rightarrow$ SirDeep$\rightarrow$ Bot. - Under Privileged Gateway Intents, toggle ON:
- β Server Members Intent
- β Message Content Intent
- Click Save Changes.
sirdeep/
βββ assets/
β βββ branding/ # High-DPI banner and contributor card assets
β βββ emojis/ # Official SirDeep developer mascot emoji pack
β βββ fonts/ # Bundled TrueType typography
βββ config/
β βββ config.example.yaml # Server channels, thresholds, and station configs
β βββ debates.json # Curated technical dilemma pool
βββ docs/
β βββ USAGE_GUIDE.md # Comprehensive operator manual
βββ src/
β βββ core/
β β βββ audit.py # Real-time Discord audit log gateway listener
β β βββ config.py # Typed dataclass configuration parser
β β βββ security.py # Anti-nuke velocity limiter and quarantine logic
β βββ modules/
β βββ ai/ # Hybrid Ollama/OpenRouter chat engine
β βββ debates/ # Daily scheduled architectural debates
β βββ leveling/ # PIL high-DPI card renderer & XP engine
β βββ radio/ # Low-latency FFmpeg audio demuxer
βββ .env.example # Clean environment variables template
βββ .gitignore # Strict secret & runtime artifact filter
βββ docker-compose.yml # 1-command container orchestration
βββ Dockerfile # Debian-slim production container
βββ LICENSE # MIT License
βββ main.py # Asynchronous Discord bot entrypoint
βββ requirements.txt # Hardened production dependencies
βββ SECURITY.md # Coordinated vulnerability disclosure policy
SirDeep is developed and maintained by the OpenWinter (@opensourcewinter) engineering community.
- π Official Website: openwinter.dev
- π Review our Contributing Guidelines for coding standards, type hints, and PR workflow.
- π Review our Code of Conduct for community values.
- π Review our Security Policy for private vulnerability reporting.
Distributed under the MIT License. Β© 2026 OpenWinter.
Empowering open-source engineering communities.
