March7thAssistant README

The project's README from github.com/moesnow/March7thAssistant. As one markdown file: README.md.


March7thAssistant

moesnow%2FMarch7thAssistant | Trendshift

🌟 点一下右上角的 Star,Github 主页就能收到软件更新通知了哦~
Star

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

快速上手,请访问:使用教程

遇到问题,请在提问前查看:FAQ

功能简介

详情见 图形界面设置 或 配置文件|QQ群 点击跳转 TG群 点击跳转 哔哩哔哩 点击跳转

界面展示

README

注意事项

下载安装

前往 Releases 下载后解压双击三月七图标的 March7th Launcher.exe 打开图形界面

源码运行

如果你是完全不懂的小白,请通过上面的方式下载安装,可以不用往下看了。

推荐使用 Python 3.12 或更高版本。

Windows 下如果通过终端启动,建议使用管理员模式打开 PowerShell、Windows Terminal 或 CMD;Windows 11 24H2 及以上也可以按 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

如果使用 uv,推荐直接使用项目自带的 pyproject.toml 工作流:

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

# 启动图形界面
uv run python app.py

# 查看命令行帮助
uv run python main.py -h

# 执行完整运行
uv run python main.py

# 执行每日实训
uv run python main.py daily
开发相关

获取 crop 参数表示的裁剪坐标可以通过小助手工具箱内的捕获截图功能


如果喜欢本项目,可以微信赞赏送作者一杯咖啡☕

您的支持就是作者开发和维护项目的动力🚀

sponsor


相关项目

March7thAssistant 离不开以下开源项目和运行时依赖的帮助,感谢所有维护者与贡献者:

此外,requirements.txt 中还包含大量底层依赖,在这里不一一列出;同样感谢这些项目对本项目的支持。

Contributors

Stargazers over time

Star History Chart

March7thAssistant (moesnow/March7thAssistant)

Searching Database…

What is this?March7thAssistant is a full-automation bot for the game Honkai: Star Rail. It handles daily chores like clearing stamina, daily training, claiming rewards, and commissions, plus weekly content such as Memory of Chaos, Pure Fiction, and Apocalyptic Shadow.
Is this a standalone app or do I need to run Python code myself?It ships as a packaged Windows desktop app with a GUI launcher (March7th Launcher.exe). You only need Python if you choose to run it from source instead of the prebuilt release.
How do I get it running?Download the latest release, unzip it, and double-click March7th Launcher.exe to open the GUI. It also supports running inside Docker via the provided docker-compose setup.
Do I need to install Python myself?No, the packaged release is self-contained. Python 3.12 or newer is only needed if you build and run from source.
Does it support Cloud Star Rail, or only the regular client?Cloud · Star Rail is supported, including background running, windowless running, and running inside Docker.
What does it actually watch to play the game for me?It captures the screen and uses OCR plus OpenCV/PyAutoGUI for recognition and automation, accelerated by ONNX Runtime and OpenVINO on CPU or GPU.
Can it export my gacha (warp) history?Yes, it can export your wish/warp records in the UIGF or SRGF standard formats.
Will it tell me when a task is done?It can push notifications about daily training and other task status, and optionally play a sound, close the game, or shut down the PC when a run finishes.
Can it auto-launch based on my stamina?Yes, you can configure it to start automatically once stamina or task refresh reaches a value you set.
Is the documentation only in Chinese?No, the README and guides are also available in Traditional Chinese, English, Japanese, and Korean.
Creator
moesnow
Size
46.2 MB
Stars
11.7K
Age
3y
Commits · 90 Days