{"id":15901744,"url":"https://github.com/seriaati/hakushin-py","last_synced_at":"2025-08-25T00:31:49.100Z","repository":{"id":236496034,"uuid":"792724250","full_name":"seriaati/hakushin-py","owner":"seriaati","description":"Async API wrapper for hakush.in written in Python","archived":false,"fork":false,"pushed_at":"2024-12-16T00:58:37.000Z","size":414,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-16T01:32:19.106Z","etag":null,"topics":["api-wrapper","genshin-impact","hakushin","honkai-star-rail","hoyoverse","python","star-rail"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/hakushin-py/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seriaati.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-27T11:50:47.000Z","updated_at":"2024-12-16T00:58:41.000Z","dependencies_parsed_at":"2024-10-28T06:53:34.515Z","dependency_job_id":"a0c2ff21-86e9-4cc4-9df9-48f90c7b8681","html_url":"https://github.com/seriaati/hakushin-py","commit_stats":{"total_commits":147,"total_committers":4,"mean_commits":36.75,"dds":0.3877551020408163,"last_synced_commit":"5f40c04ec85fd5403a311adc55a6579761888225"},"previous_names":["seriaati/hakushin-py"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seriaati%2Fhakushin-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seriaati%2Fhakushin-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seriaati%2Fhakushin-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seriaati%2Fhakushin-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seriaati","download_url":"https://codeload.github.com/seriaati/hakushin-py/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230852591,"owners_count":18290081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-wrapper","genshin-impact","hakushin","honkai-star-rail","hoyoverse","python","star-rail"],"created_at":"2024-10-06T11:05:51.263Z","updated_at":"2025-08-25T00:31:49.073Z","avatar_url":"https://github.com/seriaati.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hakushin-py\n\n## Introduction\n\nhakushin-py is an async API wrapper for [hakush.in](https://hakush.in/) written in Python.\n\nhakush.in is a website that displays Genshin Impact, Honkai Star Rail, Zenless Zone Zero, and Wuthering Waves game data.\n\nDeveloping something for Hoyoverse games? You might be interested in [other API wrappers](https://github.com/seriaati#api-wrappers) written by me.\n\n\u003e Note: I am not the developer of hakush.in\n\n## Important Note\n\nThis wrapper does not support all endpoints from hakush.in, it is mainly focused on fetching the beta game data. This means I selectively chose the endpoints and API fields that I personally think are useful for theorycrafting. If you want a more complete wrapper for game data, use [ambry.py](https://github.com/seriaati/ambr) and [yatta.py](https://github.com/seriaati/yatta) instead.\n\nHowever, **there is an exception for ZZZ**, since Project Ambr and Yatta has no equivalent for ZZZ, this wrapper supports all endpoints for the ZZZ Hakushin API.\n\nWuthering Waves support is currently not planned.\n\n## Features\n\n- Fully typed.\n- Fully asynchronous by using `aiohttp`, and `asyncio`, suitable for Discord bots.\n- Provides direct icon URLs.\n- Supports Python 3.11+.\n- Supports all game languages.\n- Supports persistent caching using SQLite.\n- Supports [Pydantic V2](https://github.com/pydantic/pydantic), this also means full autocomplete support.\n\n## Installation\n\n```bash\n# pypi\npip install hakushin-py\n\n# git\npip install git+https://github.com/seriaati/hakushin-py.git\n```\n\nNote: This wrapper changes very rapidly since the Hakushin API also changes very rapidly to keep up with the latest game data changes, so I recommend installing the git version, which has more update to date fixes.\n\n## Quick Example\n\n```py\nimport hakushin\nimport asyncio\n\nasync def main() -\u003e None:\n    async with hakushin.HakushinAPI(hakushin.Game.GI, hakushin.Language.EN) as client:\n        await client.fetch_characters()\n    async with hakushin.HakushinAPI(hakushin.Game.HSR, hakushin.Language.JA) as client:\n        await client.fetch_light_cones()\n    async with hakushin.HakushinAPI(hakushin.Game.ZZZ, hakushin.Language.KO) as client:\n        await client.fetch_weapons()\n\nasyncio.run(main())\n```\n\n## Getting Started\n\nRead the [documentation](https://gh.seria.moe/hakushin-py) to learn more about on how to use this wrapper.\n\n## Questions, Issues, Feedback, Contributions\n\nWhether you want to make any bug reports, feature requests, or contribute to the project, simply open an issue or pull request in this repository.\n\nIf GitHub is not your type, you can find my contact information on [my GitHub profile](https://github.com/seriaati).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseriaati%2Fhakushin-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseriaati%2Fhakushin-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseriaati%2Fhakushin-py/lists"}