{"id":30865594,"url":"https://github.com/flagro/telegramrpbot","last_synced_at":"2025-09-07T21:23:56.235Z","repository":{"id":265388051,"uuid":"759381388","full_name":"Flagro/TelegramRPBot","owner":"Flagro","description":"Add a roleplay AI bot to your group chats","archived":false,"fork":false,"pushed_at":"2025-09-05T20:13:13.000Z","size":864,"stargazers_count":5,"open_issues_count":20,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-05T21:20:03.416Z","etag":null,"topics":["chatbot","docker","llm","mongodb","openai","python","rag","retrieval-augmented-generation","telegram-bot"],"latest_commit_sha":null,"homepage":"https://flagrotown.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Flagro.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-18T12:46:40.000Z","updated_at":"2025-09-05T20:13:16.000Z","dependencies_parsed_at":"2025-08-09T14:12:52.551Z","dependency_job_id":"4ff216ba-52a8-4e8c-a31f-d5a144679816","html_url":"https://github.com/Flagro/TelegramRPBot","commit_stats":null,"previous_names":["flagro/telegramrpbot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Flagro/TelegramRPBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flagro%2FTelegramRPBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flagro%2FTelegramRPBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flagro%2FTelegramRPBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flagro%2FTelegramRPBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Flagro","download_url":"https://codeload.github.com/Flagro/TelegramRPBot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flagro%2FTelegramRPBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274098226,"owners_count":25221961,"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","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chatbot","docker","llm","mongodb","openai","python","rag","retrieval-augmented-generation","telegram-bot"],"created_at":"2025-09-07T21:23:53.183Z","updated_at":"2025-09-07T21:23:56.220Z","avatar_url":"https://github.com/Flagro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **ChatGPT Telegram RP (RolePlay) Bot**: Add a roleplay bot in your group chats\n\nBring the ability to setup a full roleplay experience in your telegram group chats.\n\nNote: Currently this is the work in progress.\n\n## Features\n- Create and use chat-bounded chat modes by describing the agent and how you want it to act\n- Introduce yourself to the model\n- Add facts about yourself or other people that the model would later use\n- Chat with the bot\n    - Send it text\n    - Send it pictures\n    - Send it voice messages\n    - Receive back text\n    - Receive back puctures\n- Flexible tracking of the AI resources usage\n- Flexible permissions and limits\n- This bot is built with the idea of not being constrained by just Telegram bot, it could be adapted for most other platforms as well.\n\n## Bot commands\n- `/start` - Start the bot in current chat\n- `/stop` - Stop the bot in current chat\n- `/reset` – Reset the dialogue history\n- `/mode [mode]` – Select chat mode from existing ones\n- `/addmode [mode] [description]` - Add new chat mode\n- `/deletemode [mode]` - delete existing chat mode from this chat\n- `/introduce [your introduction]` - Add fact about yourself\n- `/fact [@tg_handle] [fact]` - add fact about the person within the chat\n- `/clearfacts [@tg_handle]` - delete facts for given person\n- `/usage` – Show usage limits for your user\n- `/language` - Set bot preferred language\n- `/conversationtracker` - Turn on/off the conversation tracker for current chat\n- `/autofact` - Turn on/off the automatic fact extraction for the current chat based on chat history\n- `/autoengage` - Turn on/off the automatic engage mode (the bot will reply to your messages when it finds it necessary)\n- `/ban [@tg_handle]` - Ban the user (could work by replying to user's message as well)\n- `/unban [@tg_handle]` - Unban the user\n- `/help` – Show help\n\n## Setup\n1. Get your [OpenAI API](https://openai.com/api/) key.\n\n2. Get your Telegram bot token from [@BotFather](https://t.me/BotFather).\n\n3. Compose a `.env` file locally according to the `.env.example` file. Make sure to specify proper database credentials.\n\n4. Run docker containers with `docker-compose.yaml` file by doing `docker-compose up` locally.\n\n5. (Optional) TODO: for more advanced use cases you can setup environment for automatic deployment (see `.github/workflows/deploy.yaml`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflagro%2Ftelegramrpbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflagro%2Ftelegramrpbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflagro%2Ftelegramrpbot/lists"}