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! ๐
- 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.
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 ๐ค.
- Create and activate your virtual environment.
source /.../my-env/bin/activate-
Inside of your virtual enviroment, clone the repository:
git clone https://github.com/Hoshimya-Animation/hoshiTelegramBot
cd hoshiTelegramBot/ -
Install the required dependencies:
pip3 install -r requirements.txt --no-deps
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. ๐
-
Open the file main.py and replace your Telegram Token of your Bot on
TELEGRM_TOKEN, i.e."123+2". -
Run the bot: ๐ค
python3 main.py
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 information about an anime from MyAnimeList ๐๐๐บ (japanese or english)./mangarequest [name]- Request information about a manga from MyAnimeList ๐๐๐ (japanese or english)./random- Random information about an anime ๐ฒ/mangarand- Random information about a manga ๐ฒ๐/hoshiimanga [gender]- Manga suggestion by gender ๐ฑ๐./showgen- Show all available genders ๐๐./hoshii [gender]- Anime suggestion by the gender ๐๐ฑ ./help- Give you information about my functions ๐โ.
This project is licensed under the AGPL-3.0 License. See the LICENSE file for more details.
We welcome contributions from the community! Please read the CONTRIBUTING file for guidelines on how to contribute to this project.
A big thank you to the developers of the Jikan API and Google for providing the data that makes this bot possible.
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
