Install and open
Install Aldwin, open it in your browser with aldwin web, and stop it when you are done.
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.
-
Install uv, the tool that installs Aldwin:
curl -LsSf https://astral.sh/uv/install.sh | sh -
Close the terminal and open a new one.
-
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#
- In a terminal, run
aldwin web. - Your browser opens on Aldwin. If it does not, copy the link the terminal printed into your browser.
- 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#
| Option | What it does |
|---|---|
--no-open | Print the link without opening a browser |
--port 8000 | Use another port. By default Aldwin uses 7841, or any free port if 7841 is busy |
--workspace ~/notes | Work in this folder for this run, instead of the usual workspace |
--host localhost | Listen 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.