Hoshimya-Animation/hoshiiTelegramBot

A Telegram bot that fetches anime details from various APIs, including Jikan API and Google. The bot supports multiple languages and provides personalized recommendations. 🌟

🌸 hoshiiTelegramBot 🌸

Welcome to the hoshiiTelegramBot! This adorable Telegram bot fetches anime and manga details from various APIs, including Jikan API and Google. It supports multiple languages and provides personalized! 🌟

🌟 Features

• Fetches detailed information about anime and manga from Jikan API and Google.
• Supports multiple languages for a global audience.
• Provides personalized recommendations based on your preferences.
• Cute and user-friendly interface for the best experience.

🛠️ Installation

Tip

Use a virtual environment. Don't know how to create one? Let me show you how to create it. 👉 Click here documentation.

Note

Previously, you should have created your Telegram Bot. Please, If you don't do it yet, check the official documentation 🤖.

1. Clone the repository:

   git clone https://github.com/Hoshimya-Animation/hoshiTelegramBot
   cd hoshiTelegramBot

2. Install the required dependencies:

   pip3 install -r requirements.txt

Important

If a message error apears about googletrans about httpx version or jikanApi or TelegramBot, please follow this steps.

• Install manually httpx.

  # Install httpx version greater equal to 0.13.3
  pip3 install "httpx>=0.13.3"
  pip3 install googletrans==4.0.0-rc1

• For Jikan Api.

  # Install api
  pip3 install jikanpy-v4

• Finally TelegramBot.

  # Install python-telegram-bot
  pip3 install python-telegram-bot

3. Open the file main.py and replace your Telegram Token of your Bot on TELEGRM_TOKEN, i.e. "123+2" .

4. Run the bot: 🤖

   python main.py

🌐 Usage

Add the bot to your Telegram and start chatting with it! Use the following commands to get started:

• /start - The bot starts ₍^ >ヮ<^₎ .ᐟ. kawaii journey!
• /language- Change language of the Bot 🇪🇸 ➡️ 🇬🇧 (Available in Spanish, English, French, Italian, Traditional Chinese, Japanese, Hindi, German, Arabic, Romanian, and Korean)
• /request [name] - Request a new anime from our database (still in progress) or if it's available on MyAnimeList list 🗄 (Japanese or English).
• /random - Random information about an anime 🎲
• /hoshii [gender] - Anime suggestion by the gender 🌍🍱 (Action, Comedy, Horror, Sports, Adventure, Drama, Mystery, Supernatural, Avant Garde, Fantasy, Romance,Suspense, Award Winning, Girls Love, Sci-Fi, Boys Love,Gourmet, Slice of Life, Ecchi, Erotica, Hentai).
• /help - Give you information about my functions 🆘❔.

🔧 Configuration

Note

If you run main.py the interpreter shows you this message AttributeError: module 'httpcore' has no attribute 'SyncHTTPTransport

Important

Googletrans has an important issue nowadays. HTTPX package version for Googletrans is 0.13.0, on other hand, Python-Telegram-Bot requires the version 0.27.0. Therefore there is a problem. However, you can fix temporaly this issue.

• In a new terminal use this command

  pip list -v

Note

This command shows you all packages installed with pip.

• Then, search for the package googletrans🔤, go to the path where it's installed, and ONLY MODIFY ⚠️ the file client.py. In this file, on line 62, you can comment it out and below it, type this:

  proxies: typing.Dict[str, httpcore.AsyncHTTPProxy] = None,

• Finally, save the document. 📄

📜 License

This project is licensed under the AGPL-3.0 License. See the LICENSE file for more details.

🙌 Contributing

We welcome contributions from the community! Please read the CONTRIBUTING file for guidelines on how to contribute to this project.

💖 Acknowledgements

A big thank you to the developers of the Jikan API and Google for providing the data that makes this bot possible.

📬 Contact

If you have any questions or suggestions, feel free to open an issue or reach out to us at hoshimiyanimation.contact@protonmail.com.

Made with 💖 by Hoshimya Animation, John