{"id":22432689,"url":"https://github.com/1999azzar/sakurav2","last_synced_at":"2025-09-08T00:03:24.536Z","repository":{"id":229532778,"uuid":"776974908","full_name":"1999AZZAR/sakurav2","owner":"1999AZZAR","description":"Heavily stripped-down version of my original SakuraAI-Bloom Telegram bot, powered by Gemini and stability AI.","archived":false,"fork":false,"pushed_at":"2024-03-26T19:46:52.000Z","size":86,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T12:45:49.870Z","etag":null,"topics":["gemini-api","llm","stability-ai","telegram-bot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/1999AZZAR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-03-24T23:53:41.000Z","updated_at":"2024-03-26T19:58:08.000Z","dependencies_parsed_at":"2024-03-25T01:24:34.502Z","dependency_job_id":"31214a71-f77d-4bd8-9e52-8b44c6cdcc0b","html_url":"https://github.com/1999AZZAR/sakurav2","commit_stats":null,"previous_names":["1999azzar/sakurav2"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fsakurav2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fsakurav2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fsakurav2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fsakurav2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1999AZZAR","download_url":"https://codeload.github.com/1999AZZAR/sakurav2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245806038,"owners_count":20675291,"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":["gemini-api","llm","stability-ai","telegram-bot"],"created_at":"2024-12-05T22:12:34.827Z","updated_at":"2025-03-27T07:42:48.900Z","avatar_url":"https://github.com/1999AZZAR.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sakura V2\n\nA strip down version of [SakuraAi-Bloom](https://github.com/1999AZZAR/sakuraAI_Bloom) but with more fluid conversational behavior.\n\n## Overview\n\nThis Telegram chat bot is designed to provide users with a variety of functionalities, including generating chat responses, creating images based on prompts, and resetting conversation histories. The bot integrates two main components: Gemini Chat, which generates text-based responses, and Stability Image Generator, which creates images based on textual prompts.\n\n## Functionality\n\n1. **Chat Responses:** Users can engage in text-based conversations with the bot, receiving responses generated by the Gemini Chat model. The responses aim to simulate conversation with an AI entity named Sakura, characterized by a friendly and eager-to-please demeanor.\n2. **Image Generation:** Users can prompt the bot to generate images based on provided textual prompts. The Stability Image Generator utilizes an AI model to create images corresponding to the input prompts, adding a watermark for authenticity.\n3. **Conversation Reset:** Users have the option to reset the conversation history, clearing previous interactions with the bot.\n\n## How to Run\n\nTo run this Telegram chat bot, follow these steps:\n\n1. **Prerequisites:**\n   - Ensure you have Python installed on your system (version 3.6 or higher).\n   - Set up a Telegram bot and obtain the API token.\n   - Obtain API keys for Gemini Chat and Stability Image Generator by signing up for the respective services.\n\n2. **Environment Setup:**\n   - Clone or download the repository containing the bot's code files.\n   - Install the required Python packages by running:\n\n     ```sh\n     pip install -r requirements.txt\n     ```\n\n3. **Configuration:**\n   - Create a `.env` file in the project directory and add the following environment variables:\n\n     ```text\n     TELEGRAM_KEY=your_telegram_bot_api_token\n     GEMINI_API_KEY=your_gemini_chat_api_key\n     STABILITY_API_KEY=your_stability_image_generator_api_key\n     ```\n\n   - Ensure that the `.env` file is properly configured with the correct API keys.\n\n4. **Change the response behavior(optional):**\n   - open the `gemini_res.py` file.\n   - on the `chat_instruction` part u can change the instruction as u like.\n   - save the file and done, you have successfully change the generated response behavior.\n   - or u can just leave it as it is, but i need to remind u that the instruction for now can make the behavior to be to lewd.\n\n5. **Run the Bot:**\n   - Execute the `main.py` script to start the bot:\n\n     ```text\n     python main.py\n     ```\n\n   - Once the bot is running, it will be active on Telegram and ready to respond to user interactions.\n\n## Other Details\n\n- **Gemini Chat:** This component simulates conversation with an AI entity named Sakura, adhering to specific personality traits and conversation guidelines. It utilizes the GenAI API for text generation.\n- **Stability Image Generator:** This component generates images based on textual prompts provided by users. It utilizes an AI model to create images and adds a watermark for authenticity.\n- **Conversation History:** The bot maintains a conversation history to track user interactions and generate contextually relevant responses.\n- **Error Handling:** The bot includes error handling mechanisms to gracefully handle exceptions and provide informative error messages to users.\n- **Security:** Ensure that API keys and sensitive information are kept secure and not shared publicly. Implement best practices for securing bot interactions and user data.\n- **Maintainer:** This bot is maintained by [azzar](https://github.com/1999AZZAR/). For inquiries or support, please contact me.\n\n## Disclaimer\n\nThis bot is provided as-is and may undergo updates or changes over time. Use it responsibly and adhere to Telegram's terms of service and guidelines for bot development and usage.\n\n## Acknowledgments\n\nSpecial thanks to the developers and contributors of the GenAI API, Gemini Chat, and Stability Image Generator for their innovative technologies and services.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Fsakurav2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1999azzar%2Fsakurav2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Fsakurav2/lists"}