Skip to content
Guide

Common questions

Short answers about cost, privacy, models, and what Aldwin can and cannot do.

On this page

Cost#

Is Aldwin free?#

Yes. Aldwin is open source under the Apache 2.0 license, and there is no Aldwin account or subscription.

So what might I pay for?#

Only the services you choose to connect:

  • A cloud model, such as OpenAI or Anthropic, charges for what you use. A local model with Ollama or LM Studio is free.
  • Web search is free with self-hosted SearXNG. Hosted search providers have free allowances or paid plans.

See Models and Search for what each costs.

Privacy#

Where is my data kept?#

On your computer, in the ~/.aldwin folder: conversations, memory, skills, settings, keys, and app sign-ins. Aldwin has no servers of its own.

What leaves my computer?#

Your messages, and the files Aldwin reads to answer them, go to the model you chose. With a local model, that is your own computer. Searches go to your search provider, and app actions go to that app. The full list is on Privacy.

Can I use Aldwin with no internet?#

Yes, with a local model. Web search and connected apps need the internet, and the rest works offline.

Can someone else on my network open my Aldwin?#

No. The web app only accepts connections from your own computer, and needs a private link that changes each time you start it.

Choosing and using#

Which model should I pick?#

To try Aldwin for free without installing anything else, use a Google Gemini key on its free tier. To keep everything on your computer, use Ollama. For the strongest results, use a paid cloud model. You can switch at any time.

Web app or terminal?#

They do the same things and share everything. Most people prefer the web app. See Web app or terminal.

Does Aldwin work on Windows?#

Not yet. It runs on macOS and Linux.

Can I use it on my phone?#

No. Aldwin runs on your computer and only that computer can open it.

Can Aldwin break something?#

Aldwin asks before it changes a file, runs a command, or acts in an app, and shows you exactly what it will do. It refuses a short list of dangerous actions outright. An approved change is a real change, so read before you allow, and keep backups. See Safety.

What happens when a chat gets long?#

Aldwin writes itself notes on the older part and keeps going, and every message stays on your screen. You don't need to start a new chat. See Long chats.

Can Aldwin make mistakes?#

Yes. Like any AI assistant, it can be wrong or misread a request. Check answers that matter.

Looking after it#

How do I update Aldwin?#

Run uv tool upgrade aldwin in a terminal. Everything you have is kept. The changelog lists what is new.

How do I remove Aldwin?#

Run aldwin uninstall. Your data stays in ~/.aldwin in case you come back. To delete your data too, run aldwin uninstall --purge, which asks you to confirm first.

Where do I ask for help or suggest something?#

Open an issue on GitHub.

Was this page helpful?