Skip to content
/ Kitan Public
forked from TelechaBot/Kitan

🌟 Kitan: A Telegram bot guardian ensuring friendly interactions by authenticating users as real humans with cutting-edge verification methods.

License

Notifications You must be signed in to change notification settings

sudoskys/Kitan

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Kitan

License Python 3.9+ Version

🌟 Kitan

Kitan is a Telegram bot guardian responsible for ensuring that users are friendly real human beings. It is an open-source project developed using Python and Vue.

πŸ‘‹ User-friendly and incorporating risk control technology, Kitan provides a safe and pleasant chat environment, effectively preventing personal attacks and advertisements from real human harassments.

Invite the bot to your group

πŸš€ Why Choose Kitan

Traditional verification methods like captchas, security questions, and puzzles can be circumvented with human assistance. Moreover, not all advertisement senders are bots; real users may also send ads.

Hence, we need a verification method tailored to the current environment, ensuring that users are within the platform and have undergone self-defense testing.

Kitan achieves this by using quick fingerprint verification and puzzle proof-of-work within the authentication mechanism to ensure users are real humans.

Additionally, Kitan employs risk control techniques, combining LLM/NLP/big data technologies for AI behavior analysis, monitoring user behavior from joining to leaving groups, effectively preventing personal attacks and real human advertisement harassment.

πŸ›‘οΈ Verification Methods

  • Biometric live authentication
  • Puzzle proof-of-work verification

πŸ“š How to Use

  1. Add the bot to your group
  2. Set the bot as an administrator
  3. Grant the bot the necessary permissions
  4. The bot will automatically review new group members

The bot implements an approval-based invite mechanism, allowing only approved users to join the group, preventing situations where user approvals are hindered due to bot malfunctions.

πŸ›£οΈ Roadmap

  • Implement basic verification
  • Risk control system/ban monitoring/pre-inspection
  • Group consensus

πŸ“¦ Deploying Your Own Instance

You will need a server with Redis and MongoDB installed, a domain, and a Telegram bot.

git clone https://github.com/TelechaBot/Kitan
cd Kitan

Frontend

cd frontend
npm install
env VITE_BACKEND_URL="https://api.example.com"
# env VITE_CLOUDFLARE_SITE_KEY="optional"
npm run build
# Deploy to server

Backend

See /backend/README.MD

cd backend

cp .env.example .env
nano .env

pip install pdm
pdm install
pdm run python main.py
# Press Ctrl + C to exit
pm2 start pm2.json

anime

This image is used as decoration for this page and is not part of the project.

About

🌟 Kitan: A Telegram bot guardian ensuring friendly interactions by authenticating users as real humans with cutting-edge verification methods.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 71.4%
  • Vue 25.0%
  • TypeScript 3.1%
  • HTML 0.5%