We don't publish
your competitive advantage.

IFUsing MultiQueryRetriever or any retriever that triggers WebResearchRetriever on Windows causes ModuleNotFoundError due to unconditional import of 'pwd' in pebblo.py.

THENMove the 'import pwd' inside the try block where it is used in langchain_community/document_loaders/pebblo.py and remove the top-level import. This ensures the module is only imported on Unix-like systems and fails gracefully on Windows.

IFWhen configuring an MCP server on Windows using npx, the command fails because npx is not directly executable as a command.

THENWrap the npx command with cmd /c. Set 'command' to 'cmd' and 'args' to ['/c', 'npx', '-y', '@modelcontextprotocol/server-everything'] in the MCP server configuration for Claude Desktop or VS Code.

IFOn Windows, using cmd or older PowerShell may cause issues when running Hive scripts.

THENUse PowerShell 5.1+ and run the provided quickstart.ps1 and hive.ps1 scripts. WSL is an option but not required.

IFGitHub MCP server fails with ERR_MODULE_NOT_FOUND on ARM64 Windows when started, especially after adding a secret token to config.

THENEnsure Node.js is installed as the x64 version on ARM64 Windows, as the MCP server's module resolution may not support ARM64 paths. Alternatively, check for updated MCP server versions that address ARM64 compatibility.

IFOn Windows, executing common Unix file commands (mkdir -p, touch, rm -rf, cp -r, mv) directly via cmd.exe fails, often creating a literal '-p' directory and stalling the workflow.

THENReplace the Unix shell commands with equivalent Python pathlib/shutil operations in 'tools/command_executor.py' to ensure cross-platform compatibility.

IFOn Windows, the fetch server may timeout due to character encoding issues with non-UTF-8 output.

THENSet the environment variable PYTHONIOENCODING to utf-8 in the MCP server configuration to ensure proper encoding and prevent timeouts.

IFChatTTS on Windows fails to install or run due to pynini and nemo_text_processing dependencies that do not support Windows.

THENOpen ChatTTS/core.py, locate approximately line 143, and comment out the 7 lines that handle text normalization using pynini/WeTextProcessing. This disables the normalization step and allows the library to function on Windows without those dependencies.

IFGitHub MCP server fails with ERR_MODULE_NOT_FOUND for @modelcontextprotocol/sdk when a secret token is added to the config on Windows Arm64 (e.g., Surface Pro 11 Snapdragon).

THENInstall the x64 version of Node.js instead of the Arm64 version. On Windows, download the x64 installer from nodejs.org and reinstall. Use `node -p "process.arch"` to verify the architecture; it should return 'x64'.

IFOn Windows, executing Unix-style file commands like `mkdir -p` in the command executor creates a literal `-p` directory, causing the workflow to stall.

THENUpdate DeepCode to a version that translates `mkdir -p`, `touch`, `rm -rf`, `cp -r`, and `mv` into native pathlib/shutil calls.