https://github.com/seriaati/hoyo-buddy

A feature-rich, easy to use, beautifully designed Discord bot made for Hoyoverse gamers
https://github.com/seriaati/hoyo-buddy

discord-bot discord-py genshin-impact honkai-star-rail hoyolab-api hoyolab-auto-checkin hoyoverse miyoushe

Last synced: 6 months ago
JSON representation

A feature-rich, easy to use, beautifully designed Discord bot made for Hoyoverse gamers

• Host: GitHub
• URL: https://github.com/seriaati/hoyo-buddy
• Owner: seriaati
• License: gpl-3.0
• Created: 2023-10-13T09:45:52.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-05-05T11:27:38.000Z (6 months ago)
• Last Synced: 2025-05-05T12:38:16.519Z (6 months ago)
• Topics: discord-bot, discord-py, genshin-impact, honkai-star-rail, hoyolab-api, hoyolab-auto-checkin, hoyoverse, miyoushe
• Language: Python
• Homepage: https://hb.seria.moe
• Size: 67.5 MB
• Stars: 116
• Watchers: 3
• Forks: 9
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: changelogs/CHANGELOG_EN.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# Hoyo Buddy

![Hoyo Buddy](https://iili.io/J1JqMSR.png)  

![GitHub issues](https://img.shields.io/github/issues/seriaati/hoyo-buddy)

![GitHub pull requests](https://img.shields.io/github/issues-pr/seriaati/hoyo-buddy)

![GitHub Repo stars](https://img.shields.io/github/stars/seriaati/hoyo-buddy?style=flat)

![GitHub forks](https://img.shields.io/github/forks/seriaati/hoyo-buddy?style=flat)

![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/seriaati/hoyo-buddy)

![Lines of code](https://tokei.rs/b1/github/seriaati/hoyo-buddy?style=flat)

![Commit activity](https://img.shields.io/github/commit-activity/w/seriaati/hoyo-buddy/main)

![GitHub](https://img.shields.io/github/license/seriaati/hoyo-buddy)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

Hoyo Buddy is a feature rich, easy to use, and beautifully designed Discord bot made for Hoyoverse gamers. It is developed under the [user app](https://support.discord.com/hc/en-us/articles/21334461140375-Using-Apps-on-Discord) standard, so you can use it without inviting it into any Discord servers, and can use it anywhere you want.  

  

- [Try it Out](https://link.seria.moe/hb-start)

- [Official Website](https://hb.seria.moe/)

- [Is Hoyo Buddy Safe?](https://hb-docs.seria.moe/docs/Account-Security)

- [Why Hoyo Buddy?](https://hb-docs.seria.moe/docs/Why-Hoyo-Buddy)

- [Discord Server](https://link.seria.moe/hb-dc)

- [Documentation](https://hb-docs.seria.moe/)

## Quick Introduction

| | |

|:-------------------------:|:-------------------------:|

|![Create beautiful character cards](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-2.png?raw=true)  |  ![Make your life easier](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-3.png?raw=true)|

|![Information at your fingertips](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-4.png?raw=true)  |  ![Beauty blends with functionality](https://github.com/seriaati/hoyo-buddy/blob/assets/app-directory/nav-5.png?raw=true)|

## Features

See [documentation](https://hb-docs.seria.moe/docs/features).

## Goal

The community has been missing a Discord bot that provides support for all Hoyoverse games, and Hoyo Buddy is here to change that. We try to create **ONE** bot that can do **EVERYTHING** for all Hoyoverse games, with beautfiul designs and intuitive interfaces, all for free. Hoyo Buddy is currently the only Discord bot that provides multi-game, multi-account, and multi-language support. For more details, read this [article](https://hb-docs.seria.moe/docs/Why-Hoyo-Buddy).

## Contributing

I'm a passionate developer that loves to create open source and high quality software :)  

Wanna join us? We're looking for Python programmers, translators, and designers; join our [Discord server](https://link.seria.moe/hb-dc) to contact us.  

You can read the [Contribution Guidelines](https://github.com/seriaati/hoyo-buddy/blob/main/CONTRIBUTING.md) for more info.

## Powered By

Other projects made by me that are used in Hoyo Buddy

- [ambr.py](https://github.com/seriaati/ambr): API wrapper for [Project Amber](https://gi.yatta.moe), used to obtain Genshin Impact game data.

- [yatta.py](https://github.com/seriaati/yatta): API wrapper for [Project Yatta](https://sr.yatta.moe), used to obtain HSR game data.

- [hakushin.py](https://github.com/seriaati/hakushin-py): API wrapper for [hakush.in](https://hakush.in), used to obtain Genshin Impact, HSR, and ZZZ game data.

- [akasha.py](https://github.com/seriaati/akasha-py): API wrapper for [Akasha System](https://akasha.cv), used in the character damage leaderboard feature.

- [enka.py](https://github.com/seriaati/enka-py): API wrapper for [Enka Network](https://enka.network), used to obtain Genshin Impact and Honkai Star Rail player showcase data.

- [enka-card-api](https://github.com/seriaati/enka-card-api): API to generate 3rd party template cards.

- [genshin.py](https://github.com/thesadru/genshin.py) (contributor): API wrapper for HoYoLAB and Miyoushe.

- [hoyo-codes](https://github.com/seriaati/hoyo-codes): API to get gift codes for all Hoyoverse games, used in the automatic code redemption feature.

- [gpy-proxy](https://github.com/seriaati/gpy-proxy): FastAPI app, used as proxy for some API requests to avoid being rate limited.

- [hoyo-buddy-assets](https://github.com/seriaati/hoyo-buddy-assets) (private): Hoyo Buddy assets, used in image generation features.

## Acknowledgements

This project can't be made without all of the [dependencies](https://github.com/seriaati/hoyo-buddy/blob/main/pyproject.toml) made by the awesome open source community.