Skip to content

About

Reply-driven thread workflows for Telegram forum chats.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

thread-router

Small Python toolkit for building Telegram forum-thread workflows without slash commands.

It focuses on three things:

  • thread-scoped rules
  • reply-to review queues
  • normal-language approvals like "yes, publish this" or "make it shorter"

Why this exists

A lot of bots become annoying the moment they require everyone to memorize the right command shape.

Threaded chats already carry useful context. One thread is for review. Another is for coordination. Another is for experiments. This repo keeps that idea simple and portable.

What is inside

  • a registry that maps review messages to the thing being reviewed
  • a topic-rules store for thread-specific behavior
  • a small action classifier for approve, revise, reject, or unclear
  • CLI commands to register and resolve reply-to actions

Quick start

python3 -m pip install -e .
python3 -m telegram_thread_router.cli rules add \
  --group-id demo-group \
  --thread-id blog-review \
  --group-label "Demo Team" \
  --thread-label "Blog Review" \
  --rule "Use short editorial Russian notes and invite normal-language replies."

Register a review target:

python3 -m telegram_thread_router.cli review register \
  --kind blog \
  --group-id demo-group \
  --thread-id blog-review \
  --message-id 71 \
  --message-body "Draft ready for review" \
  --target-path ./out/2026-03-06-post.md

Resolve a reply:

python3 -m telegram_thread_router.cli review resolve \
  --kind blog \
  --group-id demo-group \
  --thread-id blog-review \
  --message-id 71 \
  --reply-text "Да, это можно публиковать"

What this repo is not

  • not a full Telegram bot
  • not an agent runtime
  • not a CMS

It is the small workflow layer around threads, review, and human-language replies.

KikuAI website Telegram @kiku_ai GitHub @kiku-jw

Follow new projects and updates from @kiku-jw.

About

Reply-driven thread workflows for Telegram forum chats.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages