irc-related

Repositories

2

Projects Packages

2

novariusirc (0.1.0)

Published 2025-12-07 23:19:24 +01:00 by DiamantTh in irc-related/NovariusIRC

Installation

To install the package using pip, run the following command:

pip install --index-url  novariusirc

For more information on the PyPI registry, see the documentation.

About this package

Modular, multilingual IRC bot/daemon inspired by Eggdrop

NovariusIRC

NovariusIRC is a modular, multilingual IRC bot/daemon in the classic Eggdrop style. One process connects to exactly one IRC network; multi-network setups run multiple instances (or containers). The project targets Python 3.12+, ships a Poetry configuration, and exposes a CLI entry point novariusirc.

Status

This repository contains the first MVP skeleton: async IRC core with reconnect logic, config loading and validation, structured logging, i18n hooks, a command registry with role checks, a feed engine, and sample modules for moderation (warn-only) and RSS announcements. Worker pools use ProcessPoolExecutor with an optional aioprocessing extra for long-lived workers.

Quickstart

1. Install dependencies (optionally enable extras uvloop, journald, workers):

   poetry install
   

2. Copy config.example.toml to config.toml and adjust values or environment variables.
3. Optional features: create files next to config.toml named feeds.toml, moderation.toml, or workers.toml (samples in config/*.example.toml). They are loaded automatically if present.
4. Run the bot:

   poetry run novariusirc --config ./config.toml --profile default
   

Project Layout

• novariusirc/core: core services (client, config, auth, commands, logging, i18n, feeds, plugins, workers)
• novariusirc/modules: built-in modules (moderation, rss_announcer)
• novariusirc/__main__.py: CLI entry point
• config.example.toml: starter configuration
• config/*.example.toml: optional feature snippets (feeds, moderation, workers)
• licenses/Novara-Software-Freedom-License-EN.md: project license text

Notes

• Structured STDOUT logging plus rotating files under logs/; optional journald if installed.
• Secrets can be read from environment variables referenced in the config.
• Feed engine caches ETag/Last-Modified, tracks seen item ids per feed, supports custom templates ({feed}, {title}, {summary}, {link}, {published}) and User-Agent rotation/TLS settings (see config/feeds.example.toml).
• Moderation module operates in warn-only mode for the MVP.

Requirements

Requires Python: >=3.12,<4.0

Details

PyPI

irc-related/NovariusIRC

2025-12-07 23:19:24 +01:00

2

NovariusIRC Team

LicenseRef-NSFL

24 KiB

Assets (1)

novariusirc-0.1.0-py3-none-any.whl 24 KiB

Versions (1) View all

0.1.0 2025-12-07

Issues