explaingit

kraktus/pgn-mule

Analysis updated 2026-07-18 · repo last pushed 2024-02-26

TypeScriptAudience · developerComplexity · 3/5DormantSetup · moderate

TLDR

A background service that collects chess games from Lichess, Chess.com, and other sources, filters them, and serves them through a simple web URL.

Mindmap

mindmap
  root((pgnmule))
    What it does
      Aggregates chess games
      Filters and combines PGN
      Serves via web URL
    Tech stack
      TypeScript
      Redis
      Zulip
    Use cases
      Aggregate tournament games
      Filter games by round
      Standardize game notation
    Audience
      Chess coaches
      Tournament organizers
    Workflow
      Poll sources on interval
      Manage via Zulip commands
      Cache in Redis

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Aggregate chess games from Lichess, Chess.com, and other sources into one feed.

USE CASE 2

Filter a large set of games down to a specific round or game range for students.

USE CASE 3

Standardize chess notation across games pulled from different sources.

USE CASE 4

Run a continuously updated game feed for a chess study group or tournament.

What is it built with?

TypeScriptRedis

How does it compare?

kraktus/pgn-mule0xradioac7iv/tempfs7vignesh/pgpulse
Stars—00
LanguageTypeScriptTypeScriptTypeScript
Last pushed2024-02-26——
MaintenanceDormant——
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Redis for caching and Zulip for managing sources, not a standalone drop-in tool.

Copy-paste prompts

Prompt 1
Help me set up PGN Mule to pull games from a Lichess tournament and a Chess.com event together.
Prompt 2
Show me how to filter the combined PGN feed to only games from a specific round.
Prompt 3
Explain how PGN Mule uses Zulip commands to manage chess game sources.
Prompt 4
Walk me through configuring Redis as the cache layer for PGN Mule.

Frequently asked questions

What is pgn-mule?

A background service that collects chess games from Lichess, Chess.com, and other sources, filters them, and serves them through a simple web URL.

What language is pgn-mule written in?

Mainly TypeScript. The stack also includes TypeScript, Redis.

Is pgn-mule actively maintained?

Dormant — no commits in 2+ years (last push 2024-02-26).

How hard is pgn-mule to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is pgn-mule for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos