Skip to content
opensourcewinterPublic

About

The autonomous community engine & AI companion for developer Discord guilds. Self-hosted, zero telemetry, 24/7 coding radio, and dynamic PIL rank cards.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

19 Commits

Folders and files

Repository files navigation

SirDeep Banner



SirDeep Logo

SirDeep

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


❄️ Overview

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.


⚑ Feature Matrix

Subsystem Capabilities Technology Stack
Audit Sentinel Captures kicks, bans, timeouts, and channel/role lifecycle updates into #audit-logs. Discord Audit Gateway v10
Anti-Nuke Shield Intercepts rapid channel/role deletions and strips administrative roles from flagged actors. Sliding Window Velocity Limiter
AI Companion High-signal pair programming, systems debugging, and sliding-window context memory. Local Ollama GPU / OpenRouter
24/7 Deep Radio Continuous audio stream with automatic gateway reconnects on network drops. Hardware-Accelerated FFmpeg
Contributor Cards High-DPI (1000Γ—520) glassmorphic cards with anti-aliased avatars and tier progression. Pillow (PIL) Dynamic Compositor
Tech Dilemmas Automated scheduled engineering debates with automatic thread indexing. Asyncio Event Scheduler

🎭 Official Mascot & Emoji Pack

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:

πŸ† Contributor Passports

SirDeep includes a built-in graphics compositor that generates high-definition contributor profile cards directly in Python without headless browsers or external rendering APIs:

OpenWinter Contributor Passport

Progression Tiers

  • Level 1 – 4: BUILDER (Initial community onboarding)
  • Level 5 – 14: CORE CONTRIBUTOR (Consistent technical contributions)
  • Level 15+: SENIOR ARCHITECT (Architectural leadership & mentorship)

πŸ›οΈ Architecture

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
Loading

πŸš€ Quickstart

Option A: Docker Compose (Recommended)

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 -f

Option B: Local Python Environment

Prerequisites: 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

βš™οΈ Configuration

Environment Variables (.env)

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

πŸ”’ Gateway Intents Setup

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:

  1. Go to Applications $\rightarrow$ SirDeep $\rightarrow$ Bot.
  2. Under Privileged Gateway Intents, toggle ON:
    • βœ… Server Members Intent
    • βœ… Message Content Intent
  3. Click Save Changes.

πŸ“‚ Project Structure

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

🀝 Community & Contributing

SirDeep is developed and maintained by the OpenWinter (@opensourcewinter) engineering community.


πŸ“œ License

Distributed under the MIT License. Β© 2026 OpenWinter.

Built with ❄️ by OpenWinter
Empowering open-source engineering communities.

About

The autonomous community engine & AI companion for developer Discord guilds. Self-hosted, zero telemetry, 24/7 coding radio, and dynamic PIL rank cards.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages