Windows (WSL)

Run OpenGPT0 on Windows using WSL for the best experience.

While OpenGPT0 can run directly on Windows, we recommend using Windows Subsystem for Linux (WSL) for the best experience. WSL provides a Linux environment that works seamlessly with OpenGPT0’s features.

Setup

Install WSL

If you haven’t already, install WSL using the official Microsoft guide.
Install OpenGPT0 in WSL

Once WSL is set up, open your WSL terminal and install OpenGPT0 using one of the installation methods.
Terminal window
```
curl -fsSL https://opengpt0.com/install | bash
```
Use OpenGPT0 from WSL

Navigate to your project directory (access Windows files via /mnt/c/, /mnt/d/, etc.) and run OpenGPT0.
Terminal window
```
cd /mnt/c/Users/YourName/project
opengpt0
```

Desktop App + WSL Server

If you prefer using the OpenGPT0 Desktop app but want to run the server in WSL:

Start the server in WSL with --hostname 0.0.0.0 to allow external connections:
Terminal window
```
opengpt0 serve --hostname 0.0.0.0 --port 4096
```
Connect the Desktop app to http://localhost:4096

OPENGPT0_SERVER_PASSWORD=your-password opengpt0 serve --hostname 0.0.0.0

Web Client + WSL

For the best web experience on Windows:

Run opengpt0 web in the WSL terminal rather than PowerShell:
Terminal window
```
opengpt0 web --hostname 0.0.0.0
```
Access from your Windows browser at http://localhost:<port> (OpenGPT0 prints the URL)

Running opengpt0 web from WSL ensures proper file system access and terminal integration while still being accessible from your Windows browser.

Accessing Windows Files

WSL can access all your Windows files through the /mnt/ directory:

C: drive → /mnt/c/
D: drive → /mnt/d/
And so on…

Example:

cd /mnt/c/Users/YourName/Documents/project
opengpt0

Tips

Keep OpenGPT0 running in WSL for projects stored on Windows drives - file access is seamless
Your OpenGPT0 config and sessions are stored within the WSL environment at ~/.local/share/opengpt0/