Web

OpenGPT0 can run as a web application in your browser, providing the same powerful AI coding experience without needing a terminal.

Getting Started

Start the web interface by running:

opengpt0 web

This starts a local server on 127.0.0.1 with a random available port and automatically opens OpenGPT0 in your default browser.

Caution

If OPENGPT0_SERVER_PASSWORD is not set, the server will be unsecured. This is fine for local use but should be set for network access.

Windows Users

For the best experience, run opengpt0 web from WSL rather than PowerShell. This ensures proper file system access and terminal integration.

---

Configuration

You can configure the web server using command line flags or in your config file.

Port

By default, OpenGPT0 picks an available port. You can specify a port:

opengpt0 web --port 4096

Hostname

By default, the server binds to 127.0.0.1 (localhost only). To make OpenGPT0 accessible on your network:

opengpt0 web --hostname 0.0.0.0

When using 0.0.0.0, OpenGPT0 will display both local and network addresses:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

mDNS Discovery

Enable mDNS to make your server discoverable on the local network:

opengpt0 web --mdns

This automatically sets the hostname to 0.0.0.0 and advertises the server as opengpt0.local.

You can customize the mDNS domain name to run multiple instances on the same network:

opengpt0 web --mdns --mdns-domain myproject.local

CORS

To allow additional domains for CORS (useful for custom frontends):

opengpt0 web --cors https://example.com

Authentication

To protect access, set a password using the OPENGPT0_SERVER_PASSWORD environment variable:

OPENGPT0_SERVER_PASSWORD=secret opengpt0 web

The username defaults to opengpt0 but can be changed with OPENGPT0_SERVER_USERNAME.

---

Using the Web Interface

Once started, the web interface provides access to your OpenGPT0 sessions.

Sessions

View and manage your sessions from the homepage. You can see active sessions and start new ones.

Server Status

Click “See Servers” to view connected servers and their status.

---

Attaching a Terminal

You can attach a terminal TUI to a running web server:

# Start the web server
opengpt0 web --port 4096

# In another terminal, attach the TUI
opengpt0 attach http://localhost:4096

This allows you to use both the web interface and terminal simultaneously, sharing the same sessions and state.

---

Config File

You can also configure server settings in your opengpt0.json config file:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Command line flags take precedence over config file settings.