MojoPad

Getting Started with Ollama

You want to ask your own notes a question. Or summarise a page you have just finished, or have a passage explained, or draft something out of what you already wrote. MojoPad does all of that, and does it on your own Mac — nothing you write is sent anywhere, there is no account, and there is no subscription.

Getting there takes one free app and about two minutes, and you will not need to type a command anywhere. If you have ever been told to open Terminal and would rather not, this chapter is for you: MojoPad does that part now.

Why there is a second app at all

A model that writes is a large piece of software in its own right — several gigabytes of it. Putting one inside MojoPad would make every download that much heavier for everybody, including the many people who never touch these features, and it would be a worse model than the one you can choose for yourself. So MojoPad borrows one from Ollama, a free app whose whole job is to keep models on your Mac and let other apps use them.

Ollama is the only thing you install. MojoPad will not download or run an installer for you, and that is deliberate rather than laziness: the promise this app makes is that nothing happens to your Mac that you did not ask for, and an app that quietly fetches and runs programs has given that promise away. So that one step is yours. Everything either side of it is handled here.

Your first model, in about two minutes

  1. Ask MojoPad to do something with AI. Press ⇧⌘A for Ask Your Wiki, or select a few words and choose ✦Explain. If there is nothing on this Mac to answer with, MojoPad says so and offers to set it up. You can also go looking for it deliberately: Set Up Local AI… in the command palette (⇧⌘P).
  2. Click Get Ollama. Your browser opens at the Ollama download page. Download it, open the file, and drag Ollama to your Applications folder the way you would any Mac app. Then open it once, so it can start itself up.
  3. Go back to MojoPad. It has already noticed. Leave the setup window open while you install — MojoPad watches for Ollama appearing and moves on by itself. There is nothing to click to say you are done.
  4. Click Download the model. MojoPad looks at how much memory this Mac has and picks a model that suits it, so there is nothing to choose and no way to pick one that is too big. It tells you the size before it starts. A progress bar shows real progress, and you can keep working while it runs.
  5. You should see "Ready". That is it — permanently. The model stays on your Mac, and none of this has to be done again.

What to expect while it downloads

Models are large: somewhere between two and twenty gigabytes depending on your Mac, which on a normal connection is minutes rather than seconds. It happens once. You can close the window and carry on writing — stopping the download does not break anything, and starting again picks up rather than beginning from nothing.

You do not need a second model for searching. If you have read elsewhere that this needs an "embedding" model, that is a real distinction but not your problem: MojoPad carries its own small one for finding pages by meaning, and offers it separately when it is first needed. The download above is the writing half, and it is the only one you have to think about.

If something is not right

"MojoPad's AI runs on your own Mac, and this one has no model yet." Exactly what it says, and the button beside it opens the setup. This is the normal message before you have done any of the above.

It says Ollama is not running. Ollama is installed but asleep — this happens after a restart if you have not set it to open at login. MojoPad offers to start it for you, and knows the difference between "not installed" and "not running", so trust which one it tells you.

The download stopped. Click Try again. Ollama resumes from where it got to rather than starting over, so a lost connection costs you only the part that had not arrived.

Answers are very slow. The model is probably too large for this Mac to hold comfortably. Run Set Up Local AI… from the command palette again to fetch a smaller one, or see Bring your own model in Local AI, which lets a model somewhere else answer instead.

You would rather it never asked. Settings ▸ AI ▸ Use no AI at all switches off every one of these features and stops MojoPad offering. There is a per-wiki version of the same switch in the Info palette, for a document you would rather no model ever touched.

Where to go next

Local AI is the full chapter: what the two kinds of model actually do, how to choose between models once you have more than one, what runs on your Mac versus what can be sent elsewhere if you allow it, and how to switch any of it off. This chapter only gets you a working one; that one explains what you now have.