metacubex/mihomo

Analysis updated 2026-05-18

★ 29,767PythonAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((repo))
    What it does
      Fetch player data
      Retrieve character info
      Handle API responses
    Key features
      Type-safe models
      Async requests
      Data utilities
    Use cases
      Player stat trackers
      Discord bots
      Profile viewers
    Tech stack
      Python
      Pydantic
      Async support

mindmap root((repo)) What it does Fetch player data Retrieve character info Handle API responses Key features Type-safe models Async requests Data utilities Use cases Player stat trackers Discord bots Profile viewers Tech stack Python Pydantic Async support

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Build a Discord bot that displays a player's Honkai: Star Rail character roster and stats on demand.

USE CASE 2

Create a stats-tracking website that logs player progression over time and shows character level trends.

USE CASE 3

Make a profile viewer tool that fetches and displays formatted player account info and character details.

What is it built with?

PythonPydanticasyncio

How does it compare?

	metacubex/mihomo	feder-cr/jobs_applier_ai_agent_aihawk	encode/django-rest-framework
Stars	29,767	29,750	29,996
Language	Python	Python	Python
Setup difficulty	easy	moderate	moderate
Complexity	2/5	3/5	3/5
Audience	developer	general	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Mihomo is a Python library that makes it easy to retrieve and work with player data from Honkai: Star Rail, a video game, via an unofficial public API. The API returns information about a player's account and their in-game characters, things like character names, levels, rarities, and image URLs, in a structured format. The library wraps that API response in Python data models built with Pydantic, a tool that enforces data types and provides editor autocompletion. This means when you write Python code against the library, your editor knows exactly what fields are available on each object, which reduces errors. It supports two API response formats (V1 and V2) and handles asynchronous requests, meaning it can fetch data without blocking the rest of a program while waiting for the network response. It also includes small utility functions to clean up the data, for example, removing duplicate character entries or merging two snapshots of a player's character roster. The data can be saved and reloaded in formats like JSON or pickle (a Python-native binary format). Someone would use this library if they are building a bot, a stats-tracking website, or a display tool that shows Honkai: Star Rail player profiles.

Copy-paste prompts

Prompt 1

Show me how to use mihomo to fetch a player's character list from Honkai: Star Rail and print their names and levels.

Prompt 2

How do I set up async requests with mihomo to fetch multiple players' data in parallel without blocking?

Prompt 3

Write a Python script using mihomo that saves a player's character snapshot to JSON and loads it back later.

Prompt 4

How do I handle both V1 and V2 API response formats with mihomo's data models?

Frequently asked questions

What is mihomo?

Python library for fetching and managing Honkai: Star Rail player data via an unofficial API, with type-safe data models and async support.

What language is mihomo written in?

Mainly Python. The stack also includes Python, Pydantic, asyncio.

What license does mihomo use?

Use freely for any purpose including commercial, as long as you keep the copyright notice.

How hard is mihomo to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mihomo for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub metacubex on gitmyhub

Verify against the repo before relying on details.