Install
Install Aldwin, first run, upgrade, and remove.
You need a Mac or a Linux computer. This page installs Aldwin and starts it in the terminal. If you would rather use menus and buttons, the same install gives you the web app.
Install with uv#
-
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 -
Start Aldwin by typing
aldwin.
uv fetches a suitable version of Python if your computer does not have one.
Install with pip#
If you manage Python yourself, you can run pip install aldwin instead, then aldwin. This needs Python 3.11 or newer. Prefer uv if you want a clean install that upgrades in place.
First run#
The first launch creates a private home folder at ~/.aldwin. Aldwin looks for a local model (Ollama or LM Studio). If one is running, you can chat with no cloud account. Otherwise it offers a cloud provider or points you at installing a local server.
A Tavily key for web search is optional. Press Enter to skip it. Add it later with aldwin setup, use another search provider, or run self-hosted search with SearXNG (no paid key).
If you already had an OpenAI key from an earlier install, Aldwin keeps it and does not force you through setup again.
After first run, aldwin resumes your latest conversation. Type /help to see commands.
Prefer menus and buttons? Run aldwin web to open the same Aldwin in your browser. See Web app.
Fully local#
- Install Ollama or LM Studio and pull a tool-capable model.
- Install Aldwin and run
aldwin. - When Aldwin finds the local model, pick it and chat. Prompts stay on loopback.
Upgrade#
Already on an older release? Run uv tool upgrade aldwin. Conversation, memory, persona, and settings stay in ~/.aldwin.
Uninstall#
Run aldwin uninstall. Your ~/.aldwin folder stays, so you can reinstall without losing memory. To delete your data too, run aldwin uninstall --purge, which asks you to confirm first.