March7thAssistant

🌟 Click the Star in the upper-right corner to get update notifications for this project on GitHub.

<img src="https://github.com/moesnow/March7thAssistant/raw/v2026.6.8/assets/screenshot/star.gif" alt="Star" width="186" height="60">

简体中文 | 繁體中文 | English | 日本語 | 한국어

This document was translated from the Simplified Chinese version using AI. Last updated: 2026-04-24. If anything differs, the Simplified Chinese version takes precedence.

The in-game language currently supports Simplified Chinese only.

Quick start: Tutorial

Before asking for help, please check: FAQ

Feature Overview

• Daily: Spend Trailblaze Power, Daily Training, claim rewards, dispatch, field farming
• Weekly: Echo of War, Currency Wars, Divergent Universe, Memory of Chaos, Pure Fiction, Apocalyptic Shadow
• Cloud Honkai: Star Rail: Supports background execution, headless execution, and Docker deployment
• Gacha record export: Supports the UIGF / SRGF standards
• Toolbox: Auto dialogue, FPS unlock, redemption codes
• Task results such as Daily Training support push notifications
• Supports automatic start after task refresh or when Trailblaze Power recovers to a specified value
• Supports sound alerts, automatic game exit, shutdown, and more after tasks finish

For details, see the GUI settings or the configuration file | QQ group Join here TG group Join here Bilibili Visit here

Interface Preview

Notes

• If you encounter problems, please report them in Issues. Questions and discussions belong in Discussions. Chat groups are checked only occasionally.
• Pull requests are welcome. Please read the contribution guide before submitting.

Download and Installation

Download the latest release from Releases, extract it, and double-click March7th Launcher.exe with the March 7th icon to open the GUI.

Running from Source

If you are completely new to this, use the packaged release above. You can ignore the rest of this section.

Python 3.12 or newer is recommended.

On Windows, if you launch from a terminal, it is recommended to open PowerShell, Windows Terminal, or CMD as Administrator. On Windows 11 24H2 or later, you can also use Sudo for Windows.

# Installation (using venv is recommended)
git clone --recurse-submodules https://github.com/moesnow/March7thAssistant
cd March7thAssistant
pip install -r requirements.txt
python app.py
python main.py

# Update
git pull
git submodule update --init --recursive

If you use uv, it is recommended to use the built-in pyproject.toml workflow directly:

# Installation (using uv)
git clone --recurse-submodules https://github.com/moesnow/March7thAssistant
cd March7thAssistant
uv sync

# Launch the GUI
uv run python app.py

# Show CLI help
uv run python main.py -h

# Run the full workflow
uv run python main.py

# Run Daily Training
uv run python main.py daily

Development Notes

To obtain the crop coordinates used by crop parameters, you can use the capture screenshot feature in the toolbox.

If you like this project, you can support the author with a coffee via WeChat ☕

Your support helps keep the project developed and maintained.

Related Projects

March7thAssistant depends on the following open-source projects and runtime dependencies. Thanks to all maintainers and contributors.

• Simulated Universe automation https://github.com/CHNZYX/Auto_Simulated_Universe: provides Simulated Universe related capabilities
• Field farming automation https://github.com/linruowuyin/Fhoe-Rail: provides field farming related capabilities
• OCR text recognition https://github.com/RapidAI/RapidOCR: provides in-game text recognition
• GUI component library https://github.com/zhiyiYo/PyQt-Fluent-Widgets: provides the main interface components and interaction experience
• MirrorChyan https://github.com/MirrorChyan/docs: provides update checking, download distribution, and CDN acceleration related capabilities
• Image processing and automation related dependencies OpenCV, PyAutoGUI, and others: provide screenshot capture, image processing, and foundational automation capabilities
• Inference acceleration related dependencies ONNX Runtime, OpenVINO: provide CPU / GPU acceleration for OCR and model inference

Additionally, requirements.txt contains many lower-level dependencies that are not listed one by one here. Thanks as well to those projects for supporting this project.

Contributors

Stargazers over time