Mihomo is a Python library that provides Pydantic models for Honkai: Star Rail player data retrieved from the Mihomo API.
The library solves the problem of working with untyped API responses by offering structured, type-hinted data models that enable autocompletion and static type checking. It wraps the Mihomo API, which parses Honkai: Star Rail player information, and presents the data through Pydantic models that developers can use directly in their code. The tool supports two API versions: V1 and V2, each with its own set of models and fetch methods, allowing flexibility depending on which API endpoint a developer prefers to use.
Developers building tools or applications that interact with Honkai: Star Rail player data should choose this library if they want type safety and IDE autocompletion when working with API responses. It suits projects that need to fetch and process player profiles, character data, and related game information. The library includes utility functions for common data manipulation tasks, such as removing duplicate character entries and merging character datasets. It also supports data persistence through pickle and JSON serialization, making it straightforward to cache or store parsed player information locally.
The project maintains active development with regular updates to support both API versions and their evolving data structures. The codebase demonstrates responsiveness to changes in the underlying Mihomo API, with separate model directories for each version indicating deliberate maintenance of backward compatibility. The inclusion of practical tools for data transformation and the support for icon URL replacement suggest the maintainers are focused on solving real problems developers encounter when working with this data.
