Mihomo (GOAMD64=v1) MetaCubeX

Use this command to install Mihomo (GOAMD64=v1):

winget install --id=MetaCubeX.Mihomo.GOAMD64v1 -e

Mihomo is a Python library designed to provide structured data models for Honkai: Star Rail parsed data from the Mihomo API. It simplifies integration with game-related applications by offering type hints and autocompletion support.

Key Features:

Support for two data formats (V1 and V2) with comprehensive parsing capabilities.
Multi-language compatibility, allowing users to retrieve data in various languages.
Tools for managing character data, such as removing duplicates and merging updates.
Data persistence options using pickle and JSON serialization for efficient storage.

Audience & Benefit: Ideal for Python developers, game researchers, and enthusiasts working with Honkai: Star Rail data. Mihomo enables seamless integration of game statistics into applications, streamlining development workflows and enhancing productivity. It can be installed via pip.

mihomo

A simple python pydantic model (type hint and autocompletion support) for Honkai: Star Rail parsed data from the Mihomo API.

API url: https://api.mihomo.me/sr_info_parsed/{UID}?lang={LANG}

Installation

pip install -U git+https://github.com/KT-Yeh/mihomo.git

Usage

Basic

There are two parsed data formats:

V1:
- URL: https://api.mihomo.me/sr_info_parsed/800333171?lang=en&version=v1
- Fetching: use client.fetch_user_v1(800333171)
- Data model: mihomo.models.v1.StarrailInfoParsedV1
- All models defined in mihomo/models/v1 directory.
V2:
- URL: https://api.mihomo.me/sr_info_parsed/800333171?lang=en
- Fetching: use client.fetch_user(800333171)
- Data model: mihomo.models.StarrailInfoParsed
- All models defined in mihomo/models directory.

If you don't want to use client.get_icon_url to get the image url everytime, you can use client.fetch_user(800333171, replace_icon_name_with_url=True) to get the parsed data with asset urls.

Example

import asyncio

from mihomo import Language, MihomoAPI
from mihomo.models import StarrailInfoParsed
from mihomo.models.v1 import StarrailInfoParsedV1

client = MihomoAPI(language=Language.EN)


async def v1():
    data: StarrailInfoParsedV1 = await client.fetch_user_v1(800333171)

    print(f"Name: {data.player.name}")
    print(f"Level: {data.player.level}")
    print(f"Signature: {data.player.signature}")
    print(f"Achievements: {data.player_details.achievements}")
    print(f"Characters count: {data.player_details.characters}")
    print(f"Profile picture url: {client.get_icon_url(data.player.icon)}")
    for character in data.characters:
        print("-----------")
        print(f"Name: {character.name}")
        print(f"Rarity: {character.rarity}")
        print(f"Level: {character.level}")
        print(f"Avatar url: {client.get_icon_url(character.icon)}")
        print(f"Preview url: {client.get_icon_url(character.preview)}")
        print(f"Portrait url: {client.get_icon_url(character.portrait)}")


async def v2():
    data: StarrailInfoParsed = await client.fetch_user(800333171, replace_icon_name_with_url=True)

    print(f"Name: {data.player.name}")
    print(f"Level: {data.player.level}")
    print(f"Signature: {data.player.signature}")
    print(f"Profile picture url: {data.player.avatar.icon}")
    for character in data.characters:
        print("-----------")
        print(f"Name: {character.name}")
        print(f"Rarity: {character.rarity}")
        print(f"Portrait url: {character.portrait}")

asyncio.run(v1())
asyncio.run(v2())

Mihomo (GOAMD64=v1) MetaCubeX

README

mihomo

Installation

Usage

Basic

Example

Tools

Remove Duplicate Character

Merge Character Data

Data Persistence