Skip to content

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

License

Notifications You must be signed in to change notification settings

N-SUDY/hoshiiTelegramBot

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

53 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Kawaii Bot

๐ŸŒธ hoshiiTelegramBot ๐ŸŒธ

Version License Build

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
  1. Open the file main.py and replace your Telegram Token of your Bot on TELEGRM_TOKEN, i.e. "123+2" .

  2. 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 [email protected].

Kawaii Bot2

Made with ๐Ÿ’– by Hoshimya Animation, John

About

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

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%