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 ๐ค.
-
Clone the repository:
git clone https://github.com/Hoshimya-Animation/hoshiTelegramBot cd hoshiTelegramBot
-
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
-
Open the file main.py and replace your Telegram Token of your Bot on
TELEGRM_TOKEN
, i.e."123+2"
. -
Run the bot: ๐ค
python 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 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 ๐โ.
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. ๐
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 [email protected].
Made with ๐ by Hoshimya Animation, John