AnswersPublished15 sources
How to Set Up This Project on Windows 10
The project is not ready for a direct install in native Windows PowerShell or CMD; its scripts expect Linux oriented tools and features. On a compatible Windows 10 build, WSL2 with Ubuntu is the suggested route.
Published byImages generated with GPT Image 2
Research answer
Key takeaways
- The project is not ready for a direct install in native Windows PowerShell or CMD; its scripts expect Linux oriented tools and features.
- On a compatible Windows 10 build, WSL2 with Ubuntu is the suggested route. The commands below install and run the project inside Linux, not as a native Windows setup.
- Run the project’s preflight and dry run checks before deployment, and verify that your IDE is actually using the WSL environment.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the](https://d15bya8fi85z1v.cloudfront.net/chat/IbEfUgNRVbQuBwZI6xLn8uUpdIy1/images/70A21BC5961258BE376D/8C9CEB076789B956243D.png)
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"当前项目不能直接用 Windows 原生 PowerShell/CMD 完成安装；Win10 上建议采用 WSL2 + Ubuntu 路线。以下是基于已读取源码的安装建议，未在 Win10 实机验证，也未执行安装或修改项目。\n\n 兼容性结论\n\n 安装依赖 Bash、Git、GNU timeout、Pyth. Topic tags: general web, workflow, code, python, api. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts wit
The short answer: use Ubuntu in WSL2
This project is not a straightforward install in Windows PowerShell or Command Prompt. Its setup expects Bash, Git, GNU timeout, Python 3.10 or later, and PyYAML, according to the project README. Its deployment code also imports fcntl, a Python module available on Unix but not Windows.7 Installing Git Bash alongside Windows Python therefore does not, on its own, make the project compatible with native Windows.
The practical option is to install Ubuntu under the Windows Subsystem for Linux (WSL) and run the project there. One important distinction: installing files inside WSL does not automatically mean a Windows-native IDE has discovered or loaded them. The project’s mode-discovery logic targets Linux storage paths, so the IDE’s runtime environment matters too.
1. Install WSL and Ubuntu
The one-command WSL installation method applies to Windows 10 version 2004 (Build 19041) and later; older builds may require Microsoft’s manual installation steps.12
15
10
Open PowerShell as an administrator and run:12
wsl --install -d Ubuntu
Restart if prompted. The first time Ubuntu launches, create a Linux username and password.3
To check which WSL version Ubuntu is using, run:12
wsl --list --verbose
If Ubuntu shows version 1, convert it to WSL2:12
wsl --set-version Ubuntu 2
2. Install dependencies and clone the repository
Run the following commands in the Ubuntu terminal, not PowerShell. First authenticate for sudo, then install the listed packages. If a command fails, stop rather than proceeding to deployment.
sudo -v
timeout 600s sudo -n apt-get update < /dev/null &&
timeout 600s sudo -n env DEBIAN_FRONTEND=noninteractive apt-get install -y git coreutils python3 python3-yaml < /dev/null
The repository address below is the one specified by the project’s install.sh. Run the clone command from the Linux working directory where you want the checkout to live:
timeout 30s env GIT_TERMINAL_PROMPT=0 git -c core.autocrlf=false -c core.hooksPath=/dev/null clone --no-recurse-submodules --branch main https://github.com/zhaosan2023/dotfiles-bmad-solo.git dotfiles-bmad-solo < /dev/null
Then enter the repository:
cd dotfiles-bmad-solo
Before running anything, review the downloaded install.sh and bs.sh. The project README advises reviewing trusted scripts rather than piping remote code directly into a shell.
3. Run checks before deployment
From the repository root, run the read-only preflight and dry run. Both options are supported by bs.sh:
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
Proceed only if the checks pass, the targets are correct, and you are comfortable with the scripts writing to the current Linux user’s global configuration. Then deploy and check the resulting status:
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
If the checks report conflicting assets, damaged configuration or an unfinished transaction, address that issue first. Don’t delete state records or force an overwrite to get past a warning.
4. Check where your IDE is running
For VS Code, install the Windows application and its WSL extension, then connect to the Ubuntu workspace. Microsoft documents this as a way to keep the editor on Windows while development tools run in Linux.9
Still verify which extension host is running Roo and whether the mode configuration belongs to that environment. A WSL deployment should not be treated as a successful native Windows install of Antigravity, Gemini or Roo: the project’s current automatic discovery does not cover Windows-native configuration paths. The project also calls for separate runtime verification; copying files successfully does not confirm that the IDE loaded them or that permissions work as intended.
Bottom line: If you can use WSL2, try the Ubuntu-based steps above and verify the IDE’s runtime separately. If you need the project to run entirely as a native Windows application, the current code does not provide a complete installation path; it would first need Windows-specific support for file locking, permissions, directory synchronization and configuration paths.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "How to Set Up This Project on Windows 10"?
The project is not ready for a direct install in native Windows PowerShell or CMD; its scripts expect Linux oriented tools and features.
What are the key points to validate first?
The project is not ready for a direct install in native Windows PowerShell or CMD; its scripts expect Linux oriented tools and features. On a compatible Windows 10 build, WSL2 with Ubuntu is the suggested route. The commands below install and run the project inside Linux, not as a native Windows setup.
What should I do next in practice?
Run the project’s preflight and dry run checks before deployment, and verify that your IDE is actually using the WSL environment.
Sources
docs.python.orgfcntl — The fcntl and ioctl system calls — Python 3.14.8 documentation
learn.microsoft.comInstall WSL
devblogs.microsoft.comdevblogs.microsoft.com · commandline · install-wslInstall WSL with a single command now available in Windows 10 ...