March7th Assistant: Honkai Star Rail automation
March7th Assistant is a desktop automation companion for Honkai Star Rail players who want recurring daily tasks and weekly activities handled automatically. It is worth using if you already play the game regularly and can tolerate image recognition, UAC prompts, and setup work. The breadth is impressive; the operational friction is real.
Turning recurring game activities into routines
Daily stamina spending, training, rewards, assignments, and farming repeat often enough to become tedious. Weekly modes such as Simulated Universe and currency battles add another rotating routine, making one assistant that can handle refreshes, stamina thresholds, exports, and post-task alerts genuinely useful.
What March7th Assistant does
March7th Assistant is a Python desktop application that automates actions inside Honkai: Star Rail through image recognition and automation libraries. It provides a graphical interface, command-line execution, background and windowless modes, Docker support, and documented AI-assistant controls. It is a desktop automation companion rather than a standalone game server.
Daily, weekly, and utility features
- βDaily automation covers stamina spending, daily training, reward collection, assignments, and farming.
- βWeekly automation includes Echoes of War, Simulated Universe, Differential Universe, currency battles, Memory of Chaos, Fiction, and The End.
- βExecution can continue in the background, run without a window, or use Docker, with configuration available through the GUI or a YAML file.
- βGacha pull history can be exported using the UIGF and SRGF standards.
- βThe toolbox includes automatic dialogue, frame-rate limit removal, code redemption, and touch-mode controls.
- βTask completion can trigger message push, sound alerts, game shutdown, or computer shutdown; the assistant can also start after task refresh or when stamina reaches a configured value.
Where the assistant fits into a game routine
- β’Build an unattended farming routine around stamina recovery: configure a threshold, let March7th Assistant start when it is reached, and have the game closed after the selected run finishes.
- β’Keep rotating weekly content out of manual session planning by assigning the relevant modes to the assistant alongside daily resource collection.
- β’Preserve a portable gacha history outside the game by exporting pull records in UIGF or SRGF format.
- β’Run the automation on a separate machine or in a container through the documented background, windowless, or Docker deployment path.
- β’Let a command-capable AI assistant install the application, launch a task, change configuration, and inspect logs when a run needs troubleshooting.
Installing the launcher or source code
For the Windows launcher, download the latest release, extract it, and run `March7th Launcher.exe`. Source installation requires Python 3.12 or newer and the repositoryβs submodules: cmd git clone --recurse-submodules https://github.com/moesnow/March7thAssistant cd March7thAssistant pip install -r requirements.txt The README also documents a `uv` workflow using `uv sync`. On Windows, terminal launches may require an administrator-mode PowerShell, Windows Terminal, or CMD; Windows 11 24H2 and newer can instead use `Sudo for Windows`.
Strengths
- βMarch7thAssistant covers a concrete daily and weekly workload: clearing stamina, training, collecting rewards, commissions, and simulated-universe activities are automated together.
- βTask triggers are genuinely useful: routines can start after a refresh or when stamina reaches a configured value, while message push and sound notifications report completion.
- βIt fits different deployment needs, including a graphical launcher, headless operation, Docker, and a Python command-line entry point for scheduled automation.
- βGacha history can be exported using the UIGF and SRGF standards, avoiding a proprietary-only output format.
- βThe documentation supports both newcomers and automation-focused users: Releases provide a Windows launcher, while source runs use Python or uv, and command-capable AI assistants can install, configure, and troubleshoot it.
Setup and compatibility constraints
- β³The native release instructions are Windows-specific: users download an executable and run the launcher. Other native platforms are not clearly documented.
- β³Running tasks can trigger a UAC prompt, while source execution on Windows may need an administrator-mode terminal. Linux and macOS behavior therefore depends on the undocumented or container-based paths.
- β³Source development requires Python 3.12 or newer, a clone with submodules, and installation of the projectβs dependency set.
- β³OCR and image-based actions depend on the game rendering recognizable interface elements. Interface or visual changes may require recognition work rather than a pure configuration change.
- β³The README lists background, windowless, and Docker execution separately, but does not state that every daily and weekly task behaves identically in every mode.
- β³The full Docker setup is delegated to external documentation, so image configuration, session handling, and deployment expectations are not clearly documented in the repository README.
Related automation and OCR projects
Who should use this assistant
March7th Assistant suits regular Honkai Star Rail players who repeatedly run stamina-based content, claim rewards, train characters, and work through weekly modes. It is less attractive for casual players, users who cannot provide a stable game session or Windows permissions, or anyone wanting a hosted API with no local desktop setup.
Frequently asked questions
March7th Assistant is open source under the GPL-3.0 license. Its source code, launcher assets, configuration examples, and documentation are published in the moesnow/March7thAssistant GitHub repository, and the project also accepts issues and pull requests.
Commercial use is possible under the GPL-3.0 license as long as its conditions are followed. Anyone redistributing March7th Assistant, especially a modified or bundled version, must preserve the license and meet the applicable source-code obligations.
March7th Assistant automates daily stamina spending, training, reward collection, assignments, and farming. Weekly coverage includes Echoes of War, Simulated Universe, Differential Universe, currency battles, Memory of Chaos, Fiction, and The End, subject to the available operating modes.
Download the latest archive from GitHub Releases, extract it, and launch `March7th Launcher.exe`. Source users need Python 3.12 or newer, should clone with `--recurse-submodules`, install `requirements.txt`, and then run `python app.py` for the graphical interface.
March7th Assistant lists background, windowless, and Docker execution as supported capabilities. The README does not provide the complete container configuration or confirm that every task behaves the same without a game window, so consult the linked Docker guide before deployment.
Yes. The README explicitly supports DeepSeek Harness, Codex, Claude Code, and other command-capable agents. They can use the packaged skill instructions to install March7th Assistant, run tasks, modify settings, view logs, and troubleshoot through `m7a.exe`; task execution may still trigger one UAC prompt.
Still deciding about March7thAssistant?
One click hands the question to an AI along with this page β see what it says about March7thAssistant.
