fa387/claude-science-wsl-setup

Claude Science is an Anthropic product that lets an AI agent run code and execute tasks on your computer. It uses a daemon program called operon. This community-maintained repository is not from Anthropic. It provides setup scripts that automate the installation of the operon daemon on Windows machines via WSL2, which is Windows Subsystem for Linux version 2, a feature built into modern versions of Windows that lets you run a Linux environment inside Windows. The setup process has a few manual steps you do yourself first: download the official operon binary from the Anthropic website (not from this repo), confirm your WSL2 environment is version 2 and not version 1, and install a handful of build dependencies using the apt package manager. After those prerequisites, the main setup runs as a Claude Code slash command. Running it in a Claude Code session handles the rest automatically: it installs the binary to your PATH, builds a sandboxing tool called bubblewrap from source if your Ubuntu version ships with an older version, starts the daemon, and prints a login URL. The sandboxing is the security-critical part. The operon daemon can spawn Python and execute code, so it needs to be contained. The sandbox is provided by bubblewrap and socat together. The README is explicit: never run the daemon with the flag that disables the sandbox. If you hit a sandbox error, the correct fix is to address the underlying dependency, not to turn off the containment. An optional step generates a Windows batch file launcher so you can start the daemon with a double-click instead of opening a terminal each time. The README explains that the batch file is generated by Claude Code rather than shipped in the repository, because a generated file can be tailored to your specific WSL distro name and verified binary path, avoiding a class of problems a generic pre-made script would cause. The setup scripts are MIT licensed. The operon binary itself is not included and is not covered by that license.