{"id":25080270,"url":"https://github.com/sobhan-srza/anonymous-chat-bot","last_synced_at":"2026-03-02T14:37:35.144Z","repository":{"id":275563084,"uuid":"926458386","full_name":"Sobhan-SRZA/Anonymous-Chat-Bot","owner":"Sobhan-SRZA","description":"A Telegram bot for anonymous chatting with referral system and profile-based random chat.","archived":false,"fork":false,"pushed_at":"2025-04-28T14:13:24.000Z","size":157,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-28T14:46:11.446Z","etag":null,"topics":["anonymous","anonymous-chat","anonymous-chat-bot","mr-sinre","persian-caesar","sobhan-srza","telegraf","telegrafjs","telegram","telegram-bot","telegram-bot-api","telegram-bots","telegram-tool"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sobhan-SRZA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-03T09:43:04.000Z","updated_at":"2025-04-28T14:13:28.000Z","dependencies_parsed_at":"2025-04-28T14:33:15.524Z","dependency_job_id":"1a659f94-db4e-469e-a681-ca306cc706b4","html_url":"https://github.com/Sobhan-SRZA/Anonymous-Chat-Bot","commit_stats":null,"previous_names":["sobhan-srza/anonymous-chat-bot"],"tags_count":3,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sobhan-SRZA%2FAnonymous-Chat-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sobhan-SRZA%2FAnonymous-Chat-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sobhan-SRZA%2FAnonymous-Chat-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sobhan-SRZA%2FAnonymous-Chat-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sobhan-SRZA","download_url":"https://codeload.github.com/Sobhan-SRZA/Anonymous-Chat-Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sobhan-SRZA%2FAnonymous-Chat-Bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259109981,"owners_count":22806630,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anonymous","anonymous-chat","anonymous-chat-bot","mr-sinre","persian-caesar","sobhan-srza","telegraf","telegrafjs","telegram","telegram-bot","telegram-bot-api","telegram-bots","telegram-tool"],"created_at":"2025-02-07T03:19:15.116Z","updated_at":"2026-03-02T14:37:35.133Z","avatar_url":"https://github.com/Sobhan-SRZA.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Anonymous Chat Bot 🤖\n\u003cdiv align=\"center\"\u003e\n  \u003cimg align=\"right\" src=\"https://github.com/user-attachments/assets/80237687-dea3-4756-b0a0-1270a2a3d2ac\" width=40%\u003e\n  \u003cdiv align=\"left\"\u003e\n    \u003cdiv align=\"center\" \u003e\n       \u003cimg src=\"https://badges.aleen42.com/src/npm.svg\"\u003e\n       \u003cimg src=\"https://badges.aleen42.com/src/node.svg\"\u003e\n       \u003cimg src=\"https://badges.aleen42.com/src/javascript.svg\"\u003e\n       \u003cimg src=\"https://badges.aleen42.com/src/typescript.svg\"\u003e\n    \u003c/div\u003e\n    \u003cdiv align=\"center\" \u003e\n       \u003cimg src=\"https://img.shields.io/github/v/release/Sobhan-SRZA/Anonymous-Chat-Bot?label=Version\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/license/Sobhan-SRZA/Anonymous-Chat-Bot?label=License\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/last-commit/Sobhan-SRZA/Anonymous-Chat-Bot?label=Last Commit\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/release-date/Sobhan-SRZA/Anonymous-Chat-Bot?label=Last Release\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/languages/code-size/Sobhan-SRZA/Anonymous-Chat-Bot?label=Code Size\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/directory-file-count/Sobhan-SRZA/Anonymous-Chat-Bot?label=Files\"\u003e\n    \u003c/div\u003e\n    \u003cdiv align=\"center\" \u003e\n       \u003cimg src=\"https://img.shields.io/github/forks/Sobhan-SRZA/Anonymous-Chat-Bot?label=Forks\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/stars/Sobhan-SRZA/Anonymous-Chat-Bot?label=Stars\"\u003e\n       \u003cimg src=\"https://img.shields.io/github/watchers/Sobhan-SRZA/Anonymous-Chat-Bot?label=Watchers\"\u003e\n    \u003c/div\u003e\n    \u003cdiv align=\"center\" \u003e\n        \u003cimg style=\"display:block;margin-left:auto;margin-right:auto;width:30%;\" src=\"https://github-readme-stats.vercel.app/api/pin/?username=Sobhan-SRZA\u0026repo=Anonymous-Chat-Bot\u0026theme=react\"\u003e\n    \u003c/div\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\nThis project is a Telegram bot that enables users to chat anonymously. It features a referral system where each user can generate a unique referral link (without revealing their Telegram ID), profile creation (e.g., setting gender), and random anonymous chat options with filtering.\n\n\u003e **Note:** The bot supports various message types (text, stickers, photos, files, voice messages, videos, etc.) by copying messages so that the sender’s identity remains hidden.\n\n---\n\n## Features ✨\n\n- **Anonymous Chat:** Chat with random users without revealing your personal details.\n- **Referral System:** Generate a unique referral code and share your referral link without exposing your Telegram user ID.\n- **Profile Management:** Set up your profile (e.g., gender) for filtered random chats.\n- **Multi-type Messaging:** All message types (text, photo, sticker, video, etc.) are forwarded/copyed anonymously.\n- **Database Integration:** Uses [quick.db](https://www.npmjs.com/package/quick.db) with JsonDriver for storing non-sensitive data like profiles and referral codes.\n\n---\n\n## Prerequisites ⚙️\n\n- **Node.js** (v14 or higher recommended)\n- **Telegram Bot Token:** Create a bot via [BotFather](https://core.telegram.org/bots#6-botfather) and obtain your bot token.\n\n---\n\n## Setup Instructions 🚀\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/yourusername/anonymous-chat-bot.git\ncd anonymous-chat-bot\n```\n\n### 2. Install Dependencies\n\n```bash\nnpm install\n```\n\n### 3. Configure the `.env` File\n\nCreate a `.env` file in the root directory. **Make sure to provide values for at least `token` and `database_type`.**  \nBelow is an example configuration:\n\n```ini\n# Bot token (required)\ntoken=\"YOUR_TELEGRAM_BOT_TOKEN\"\n\n# Database type (required): options are \"mysql\" | \"sql\" | \"mongodb\" | \"json\"\ndatabase_type=\"json\"\n\n# (Optional) If using MongoDB:\ndatabase_mongoURL=\"your-mongo-url\"\n\n# (Optional) If using MySQL:\ndatabase_msql_host=\"your-mysql-host\"\ndatabase_msql_user=\"your-mysql-user\"\ndatabase_msql_password=\"your-mysql-password\"\ndatabase_msql_database=\"your-mysql-database\"\n\n# Source owners (optional, comma-separated list of owner IDs)\nowners='[\"123456789\", \"987654321\"]'\n\n# Anti crash controller (optional)\nanti_crash=\"true\"\n```\n\n### 4. Running the Bot\n\nYou can run the bot in development mode using `ts-node`:\n\n```bash\nnpm start\n```\n\nOr compile the TypeScript code to JavaScript and run it:\n\n```bash\nnpm run build\nnode dist/index.js\n```\n\n---\n\n## Available Commands 📜\n\n| Command     | Description                                                                                                                                    | Emoji |\n| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----- |\n| `/help`     | Preview all bot avalible commands with description.                                                                                            | ⚒     |\n| `/link`     | Send or create a referral link of your anonymous chat invite.                                                                                  | 🔗     |\n| `/settings` | Your settings in bot. (With using buttons you can customize your bot profile.)                                                                 | ⚙     |\n| `/start`    | Starts the bot. Without parameters, it shows usage instructions. With a referral parameter (`\u003creferralCode\u003e`), it connects you with a partner. | 🚀     |\n| `/stop`     | Stops the current chat session and removes you from any waiting queues.                                                                        | ✋     |\n\n---\n\n## Packages \u0026 Versions 📦\n\n| Package               | Version | Description                                                                                    | Emoji |\n| --------------------- | ------- | ---------------------------------------------------------------------------------------------- | ----- |\n| **telegraf**          | ^4.16.3 | Telegram bot framework for interacting with the Telegram Bot API.                              | 🤖     |\n| **dotenv**            | ^16.4.7 | Loads environment variables from a `.env` file.                                                | 🌱     |\n| **quick.db**          | ^9.1.7  | A simple SQLite-based database using JsonDriver for storing bot data.                          | 🗄️     |\n| **colors**            | ^1.4.0  | Adds color support to console messages, making debugging output more visually appealing.       | 🎨     |\n| **@types/node**       | ^22.5.0 | TypeScript definitions for Node.js, providing type checking and IntelliSense for Node.js APIs. | 📚     |\n| **typescript**        | ^5.5.4  | A superset of JavaScript that compiles to plain JavaScript and provides static type checking.  | 💻     |\n\n---\n\n## License\n\nThis project is licensed under the [BSD 3-Clause License](./license).\n\n---\n\n## Final Steps\n\n1. **Ensure your `.env` file is properly configured** with at least the `token` and `database_type` values.\n2. **Run `npm install`** to install all dependencies.\n3. **Start your bot** using `npm start` (or build and run the compiled JavaScript =\u003e `npm run start:build`).\n\nEnjoy using the Anonymous Chat Bot and feel free to extend its functionality as needed!\n\n---\n\n## Contact\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://srza.ir\" target=\"_blank\"\u003e\n   \u003cimg align=\"left\" src=\"https://raw.githubusercontent.com/Sobhan-SRZA/Sobhan-SRZA/refs/heads/main/images/social.png\" alt=\"Sobhan-SRZA social\" width=400px\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://t.me/d_opa_mine\" target=\"_blank\"\u003e\n   \u003cimg alt=\"Telegram\"\n    src=\"https://raw.githubusercontent.com/Sobhan-SRZA/Sobhan-SRZA/refs/heads/main/images/telegram-ch.svg\"\n    height=\"30\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://t.me/Sobhan_SRZA\" target=\"_blank\"\u003e\n   \u003cimg alt=\"Telegram\"\n    src=\"https://raw.githubusercontent.com/Sobhan-SRZA/Sobhan-SRZA/refs/heads/main/images/telegram-ac.svg\"\n    height=\"30\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://www.instagram.com/mr.sinre?igsh=cWk1aHdhaGRnOGg%3D\u0026utm_source=qr\" target=\"_blank\"\u003e\n   \u003cimg alt=\"Instagram\"\n    src=\"https://raw.githubusercontent.com/Sobhan-SRZA/Sobhan-SRZA/refs/heads/main/images/instagram.svg\"\n    height=\"30\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://www.twitch.tv/sobhan_srza\" target=\"_blank\"\u003e\n   \u003cimg alt=\"Twitch\"\n    src=\"https://raw.githubusercontent.com/Sobhan-SRZA/Sobhan-SRZA/refs/heads/main/images/twitch.svg\"\n    height=\"30\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://www.youtube.com/@mr_sinre?app=desktop\u0026sub_confirmation=1\" target=\"_blank\"\u003e\n   \u003cimg alt=\"YouTube\"\n    src=\"https://raw.githubusercontent.com/Sobhan-SRZA/Sobhan-SRZA/refs/heads/main/images/youtube.svg\"\n    height=\"30\" /\u003e\n  \u003c/a\u003e\n  \n  \u003ca href=\"https://github.com/Sobhan-SRZA\" target=\"_blank\"\u003e\n   \u003cimg alt=\"Github\"\n    src=\"https://raw.githubusercontent.com/Sobhan-SRZA/Sobhan-SRZA/refs/heads/main/images/github.svg\"\n    height=\"30\" /\u003e\n  \u003c/a\u003e\n  \n  \u003cp align=\"left\"\u003e\n   \u003ca href=\"https://discord.gg/xh2S2h67UW\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://discord.com/api/guilds/1054814674979409940/widget.png?style=banner2\" alt=\"pc-development.png\"\u003e\n   \u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp align=\"right\"\u003e\n   \u003ca href=\"https://discord.gg/54zDNTAymF\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://discord.com/api/guilds/1181764925874507836/widget.png?style=banner2\" alt=\"pc-club.png\"\u003e\n   \u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cdiv align=\"center\"\u003e\n   \u003ca href=\"https://discord.com/users/865630940361785345\" target=\"_blank\"\u003e\n    \u003cimg alt=\"My Discord Account\" src=\"https://discord.c99.nl/widget/theme-1/865630940361785345.png\" /\u003e\n   \u003c/a\u003e\n    \u003ca href=\"https://discord.com/users/986314682547716117\" target=\"_blank\" align=\"right\"\u003e\n    \u003cimg alt=\"Team Discord Account\" src=\"https://discord.c99.nl/widget/theme-1/986314682547716117.png\" /\u003e\n   \u003c/a\u003e\n  \u003c/div\u003e\n\n \u003c/div\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsobhan-srza%2Fanonymous-chat-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsobhan-srza%2Fanonymous-chat-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsobhan-srza%2Fanonymous-chat-bot/lists"}