Feature Overview

• Daily: Spend Trailblaze Power, Daily Training, claim rewards, dispatch, field farming
• Weekly: Echo of War, Simulated Universe, Divergent Universe, Currency Wars, 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, touch mode
• 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 required.

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

# Launch the GUI
python app.py

# Run the full workflow (see all subcommands: python main.py -h)
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

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