Skip to content
Guide

Install and open

Install Aldwin, open it in your browser with aldwin web, and stop it when you are done.

On this page

The web app is Aldwin in your browser. It uses the same conversations, memory, skills, and settings as the terminal, with buttons and menus instead of commands. It runs on your own computer: nothing is hosted online, and only your browser on this computer can open it.

You need a Mac or a Linux computer, and a terminal for two commands. New to terminals? The Quickstart walks through every step, including how to open one.

Install Aldwin#

The web app comes with Aldwin, so there is nothing extra to install.

  1. Install uv, the tool that installs Aldwin:

    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. Close the terminal and open a new one.

  3. Install Aldwin:

    uv tool install aldwin

Already have Aldwin? Run uv tool upgrade aldwin to get the web app. Your conversations, memory, and keys stay as they are.

Open the web app#

  1. In a terminal, run aldwin web.
  2. Your browser opens on Aldwin. If it does not, copy the link the terminal printed into your browser.
  3. Leave the terminal window open while you use Aldwin. Closing it stops the web app.

The terminal shows something like this:

Aldwin web is running at http://127.0.0.1:7841
Open this link to start: http://127.0.0.1:7841/?t=…
Press Ctrl-C to stop.

The long part at the end of the link is a one-time pass for this run. It is what lets your browser in, so do not share it. If you open the plain address without it, Aldwin asks you to use the link from the terminal.

The first time, Aldwin walks you through choosing a model. See First run.

Stop the web app#

Press Ctrl-C in the terminal that runs aldwin web. Anything you were writing in the browser stops there. Your conversations are already saved.

Next time, run aldwin web again. Each run prints a new link, so an old tab needs the new link or a reload from it.

Options#

OptionWhat it does
--no-openPrint the link without opening a browser
--port 8000Use another port. By default Aldwin uses 7841, or any free port if 7841 is busy
--workspace ~/notesWork in this folder for this run, instead of the usual workspace
--host localhostListen on localhost or ::1 instead of 127.0.0.1. Other addresses are refused

For example, aldwin web --workspace ~/projects/site opens the web app working in that folder. See Workspace and files.

Use the terminal too#

The web app and the terminal share one home folder, ~/.aldwin. A conversation you start in one shows up in the other, and a model you pick in one is used by both. One conversation can only answer in one place at a time, so if Aldwin is busy in the terminal, that same conversation waits in the browser.

Uninstall#

Run aldwin uninstall. This removes the web app and the terminal app together. Your ~/.aldwin folder stays, so you can reinstall without losing anything. To delete your data too, run aldwin uninstall --purge, which asks you to confirm first.

Next#

Was this page helpful?