kryten-bingo 0.1.1

Kryten bingo game service - manages bingo games and card tracking

"# Kryten Bingo

Kryten bingo game service - manages bingo games and card tracking for CyTube.

Features

• Real-time chat message monitoring
• User tracking and management
• Event-driven architecture using NATS
• Extensible moderation rules

Installation

Prerequisites

• Python 3.10 or higher
• Poetry
• NATS server running
• kryten-py library

Setup

1. Install dependencies:

poetry install

2. Copy the example configuration:

cp config.example.json config.json

3. Edit config.json with your settings:

{
  "nats_url": "nats://localhost:4222",
  "nats_subject_prefix": "cytube",
  "service_name": "kryten-bingo"
}

Usage

Running the Service

Using Poetry:

poetry run kryten-bingo --config config.json

Using the startup script (PowerShell):

.\start-bingo.ps1

Using the startup script (Bash):

./start-bingo.sh

Command Line Options

• --config PATH: Path to configuration file (default: /etc/kryten/bingo/config.json)
• --log-level LEVEL: Set logging level (DEBUG, INFO, WARNING, ERROR)

Event Handling

The service currently listens for:

• chatMsg: Chat messages for bingo commands

Development

Running Tests

poetry run pytest

Linting

poetry run ruff check .

Formatting

poetry run black .

License

MIT License - see LICENSE file for details "