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

Hoshimya-Animation/hoshiiTelegramBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

59 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

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. Create and activate your virtual environment.
  source /.../my-env/bin/activate
  1. Inside of your virtual enviroment, clone the repository:

    git clone https://github.com/Hoshimya-Animation/hoshiTelegramBot
    cd hoshiTelegramBot
  2. Install the required dependencies:

    pip3 install -r requirements.txt
  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 ๐Ÿ†˜โ”.

NEW UPDATES (Comming Soon)

  • Do you want to listen your favourite anime openings and endings? We're workin' on it
  • Get any recomendation about any manga? (In progress)

๐Ÿ“œ 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. ๐ŸŒŸ

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Languages