Key ideas
The handful of words these docs use, each explained in a sentence or two.
You do not need to learn these before using Aldwin. Come back when a word is unclear.
Models#
Model: the AI that reads your message and writes the answer. Aldwin is the assistant around it: it gives the model your files, memory, and tools. You choose the model, and can change it at any time.
Provider: where a model runs. A cloud provider, such as OpenAI or Anthropic, runs it on its own servers and charges for use. A local provider, such as Ollama or LM Studio, runs it on your computer for free. See Models.
API key: a long password from your account with a cloud provider. It lets Aldwin use that provider's models on your behalf. Treat it like a password.
Context: how much of a conversation a model can hold in mind at once. Long chats fill it up. When a chat gets long, Aldwin writes itself notes on the older part so it can keep going, and every message stays on your screen.
What Aldwin can do#
Tool: one action Aldwin can take, such as reading a file, searching the web, or running a command. Aldwin picks tools on its own as it works.
Skill: saved instructions for one kind of job, such as summarising a document. Aldwin comes with several, and you can ask it to make more. See Skills and tools.
App (connector): a service you connect so Aldwin can work in it, such as Notion or GitHub. The terminal calls these connectors. They use an open standard called MCP, so you will sometimes see "MCP server", which means the address an app offers for assistants to connect to.
Web search: Aldwin searches through a search provider you connect. Without one it can still open pages you name. See Search.
Staying in control#
Approval: Aldwin stops and asks before anything that changes something: editing a file, running a command, or acting in an app. See Safety.
Workspace: the folder Aldwin works in. It reads files there without asking, asks before changing them, and asks before touching anything outside it. See Workspace and files.
What Aldwin keeps#
Memory: short notes Aldwin saves about you and your work, so you do not repeat yourself. See Memory and persona.
Persona: a short description of how Aldwin should talk to you, such as concise or friendly.
Home folder (~/.aldwin): the folder on your computer where Aldwin keeps conversations, memory, skills, settings, and keys. The ~ means your own user folder.
Using a computer#
Terminal: an app where you type commands. On a Mac it is called Terminal. You need it to install and start Aldwin. The Quickstart shows how to open it.