Threadbot Telegram
codeThreadBot – A modular TypeScript + Node.js Telegram bot for managing supergroups and topics with multiple admins. Readytouse, easy to customize, and open‑source ThreadBot / A modular, open‑source Telegram bot framework for managing supergroups and topics, built with TypeScript and Node.js, using an adapter‑based architecture and a lightweight NeDB (file‑based) database. Overview ThreadBot is designed to manage Telegram supergroups with multiple admins, allowing structured topic management, automated posting, and flexible moderation workflows. The project is ready to use and easy to modify — simply provide the correct values in the environment variables and deploy. It is supergroup‑agnostic, meaning it can be used for any type of Telegram supergroup (communities, developer groups, learning hubs, DAO groups, etc.). Note: Every topic created automatically sends a message in the topic to ensure it is properly registered in the database. Platform: Telegram Language: TypeScript / Node.js Database: NeDB (embedded, file‑based) Admins: Supports multiple topic admins Goal: Clean separation of domain logic, adapters, and bot‑specific code Project Structure (high level) — Telegram bot logic (handlers, scenes, middlewares) — Chat/LLM adapters and prompts — Core entities and repository interfaces — DI container and configuration — NeDB datastores and repository implementations Quick Start Environment configuration For development and production, make sure the following files exist: — development environment variables — production environment variables Provide the required bot tokens, group IDs, and service keys in these files. Once configured, ThreadBot is ready to run. Database Uses NeDB for persistence No migrations required Schema changes are handled in repository implementations Contributing Test access (required) Before contributing, you must: Obtain your Ollama and Gemini API tokens Create a Telegram bot and get a BOT TOKEN from BotFather Join the test supergroup as an admin to validate bot behavior Development flow 1. Create a branch: 2. Add or update domain logic in 3. Implement bot behavior in 4. Register dependencies in 5. Test inside a supergroup 6. Open a PR Guidelines Keep TypeScript strict and readable Add tests where possible Use clear commit messages (, ) — ThreadBot is designed to be flexible, clean, and production‑ready. @dagmawibabi
TypeScripttelegramtelegrambot+1