Quickstart
Install Aldwin, open it in your browser, connect a model, and send your first message.
On this page
This page takes you from nothing to your first conversation, in about ten minutes. It uses the web app, so after two commands everything happens in your browser.
You need a Mac or a Linux computer. Windows is not supported yet.
1. Open a terminal#
A terminal is an app where you type commands. You only need it to install and start Aldwin.
- Mac: press ⌘ Space, type
Terminal, and press Enter. - Linux: press Ctrl+Alt+T, or find Terminal in your apps.
To run a command, paste it into the terminal and press Enter.
2. Install Aldwin#
Aldwin is installed with a small tool called uv. Install uv first:
curl -LsSf https://astral.sh/uv/install.sh | shClose the terminal and open a new one, so it picks up uv. Then install Aldwin:
uv tool install aldwinWhen it finishes, you see a line saying aldwin was installed.
3. Open Aldwin#
aldwin webYour browser opens on Aldwin. If it does not, copy the link the terminal prints after Open this link to start into your browser.
Leave the terminal window open while you use Aldwin. Closing it stops Aldwin.
4. Connect a model#
Aldwin needs an AI model to think with, and asks you to connect one. Pick whichever fits:
| You have | Pick | Guide |
|---|---|---|
| An account with OpenAI, Anthropic, Google Gemini, OpenRouter, or DeepSeek | Paste an API key | Model guides |
| No account, and you want to try for free | Paste an API key with a free Google Gemini key | Set up Gemini |
| A fairly recent computer, and you want everything to stay on it | Free, on this computer | Set up Ollama |
An API key is a long password from your account with that company. Each guide shows where to get one. Aldwin checks the key before saving it.
Then Aldwin asks your name, your work, and how you like answers. Each is optional. More detail: First run.
5. Send your first message#
Type in the box at the bottom and press Enter. A few things to try:
What can you help me with?
Remember that I prefer short answers with bullet points.
Make a file called ideas.md with three weekend project ideas.
The last one makes Aldwin ask for your OK before it creates the file. Select Allow and the file appears in your workspace, the folder Aldwin works in. See Workspace and files.
Next time#
Open a terminal and run aldwin web again. Your conversations are where you left them. To stop Aldwin, press Ctrl-C in the terminal.
What to set up next#
- Web search, so Aldwin can look things up.
- Connect apps such as Notion, Linear, or GitHub.
- Key ideas, if a word in these docs is new to you.
Something not working? See Troubleshooting.