Ask Joshua · a private AI assistant

Your AI.
On your
computer.

Joshua is an assistant that runs entirely on your own computer, a Mac or a Linux PC. It searches the web, reads your files, writes code, makes pictures and learns how you like answers, without sending your life to anyone's servers.

Download Free and open · Mac or Linux
install.sh
▸ Checking your Mac
  ✓ Apple M4 · 16 GB memory · 212 GB free · macOS 15.1

▸ A few questions
  With 16 GB of memory, Joshua uses the 8-billion-
  parameter model: the best fit for your Mac.
  Install the deep-thinking version? [Y/n] y
  Install image generation?          [Y/n] y
  Install the fine-tuning tools?     [y/N] y
  ✓ Plan: qwen3-vl 8b + deep thinking + images
         + fine-tuning · about 21 GB
  Go ahead? [Y/n] 
joshua.earth

Locally grown AI

Joshua is artificial intelligence on a human scale. It runs on the computer you already own, on a small model, with the power of the machine on your desk instead of a data centre's. No tech giant sits in the middle holding your data and setting the rules. Technology at the service of people and of the planet, not the other way round. Read the manifesto

The honest small print: the models were trained in data centres, and your computer uses electricity too. What changes is the scale, and who is in control.

Manifesto

Why it lives on your computer

> Your questions are yours

What you ask an assistant is a diary of your worries, your work and your plans. With Joshua, the model runs on your own chip. Your chats, files and memory sit in one folder on your disk, in plain files you can open, copy or delete.

> No profile, same answers

When Joshua searches the web it goes out anonymously, with no account and no cookies, so nobody builds a profile from it. The same question gets the same results on any computer, in the language you asked in.

> It works when the network doesn't

Untick the internet and Joshua keeps working: on a train, in the mountains, during an outage. Nothing switches off because a company changed its plans or its prices.

> You can see how it works, and change it

Every rule Joshua follows is in a few readable Python files. The memory it keeps about you is a notes file you can edit. And you can teach it your own style, on your own computer, with your own examples.

> You can make your own model

Joshua's model is a file on your disk, and it is yours to shape. With fine-tuning you retrain it on your own examples and create a new model of your own: one that writes in your tone, follows your formats and speaks your field's language. You keep it, you can copy it to another computer, and it stays exactly as you made it. How fine-tuning works

What you give up. A model that fits on a laptop is smaller than the giant ones in data centres: it makes more mistakes and writes less brilliantly. Joshua makes up for part of it by checking the web before it answers and fact-checking itself against its sources, and it tells you where each fact came from. It is also slower, and it needs a reasonably recent computer. If yours is too small, you can choose a cloud model for the chats that need one: see where your data lives.

Your data

Where your data lives

Everything Joshua knows about you is kept in ordinary files in one folder on your computer, ~/AskJoshua. You can open them, back them up or delete them. Joshua answers with a model on your own computer by default. You can also pick a cloud model for a chat, to get a bigger model or to help a small computer. The table shows what each choice sends out.

WhatWhere it is storedLocal modelCloud model ☁
ChatsEach chat in its own folder: ~/AskJoshua/joshua/conversations/; scheduled tasks in schedules.jsonNever leaves your computerThe chat you are in is sent with each message, so the model can answer. Your other chats are not.
FilesThe chat's files folder, or the project folder you point it toNever leave your computerOnly the text Joshua reads from them, and pictures you attach
MemoryNotes about you, as editable text: ~/AskJoshua/joshua/memory/Never leave your computerNot sent, unless you switch on “Share notes with cloud models”. The notes are always written by the model on your computer; with cloud models only, Joshua writes new notes only if sharing is on.
Your trained modelsExamples in ~/AskJoshua/joshua/finetune/, models in Ollama's folder ~/.ollamaTrained and kept on your computerTrained and kept on your computer
PicturesThe chat's files folderDrawn on your computerDrawn on your computer
Web searchesNowhere: not storedSearch words go to search engines (Yahoo, DuckDuckGo, Brave, Startpage) with no account and no cookies. Tick “No internet” to stop it.The same. The pages Joshua reads also go to the cloud model, as part of the chat.
Programs using JoshuaEach request is saved as a 🔌 chat in conversations/; the API key is in ~/AskJoshua/joshua/api.jsonOnly programs on this computer can connect, unless you allow your home network. They need the key.Only if a program asks for a cloud model by name
Updates and model listsNowhere: not storedWhen Joshua opens it asks ask.joshua.earth for the latest version number. The model lists are read from ollama.com when you open those panels. Nothing about you is sent.The same
Your Ollama accountOnly with cloud models: a key in ~/.ollama links this computer to your accountNot neededOllama knows your account and how much you use, to apply your plan's limits and billing

Local: nothing to trust

With a local model, your conversations are never sent anywhere. The only things that go out are web searches and the pages Joshua reads, and you can switch those off. This is the default.

Cloud: we trust Ollama

With a cloud model you rely on Ollama's word. Ollama says cloud prompts and replies are never logged or trained on, and that its hosting partners must keep nothing. The models run mainly in the United States, sometimes in Europe. Your computer can't check any of this, so Joshua marks every cloud chat with ☁ and tells you in the chat itself. Ollama's cloud terms

Using a cloud model

  1. Connect. Say yes to cloud models when you install, or later open ☁ Cloud models in Joshua and press Connect. A page on ollama.com opens: create an account (Continue with Google works) or sign in, and approve your computer.
  2. Pay per use, a little at a time. New Ollama accounts pay per use: you add credit on ollama.com, with no subscription. That money pays Ollama for the computing power of its servers; Joshua itself is free and gets none of it. Gemma 4 31B, which also sees images and which Joshua sets up for you, is one of the cheapest: well under a cent per message, so a few dollars last a long time. Some older accounts still have a small free monthly allowance. Bigger models cost more per message; if you use them a lot, a plan such as Pro ($20 a month with $60 of use included) works out cheaper.
  3. Add a model. Choose + Add a model… at the bottom of the model menu under the prompt (or open ☁ Cloud models), pick one from the list (👁 means it can also see images) and press Add to the model menu. Nothing is downloaded.
  4. Choose it per chat. Pick the ☁ model under the prompt. Joshua starts every new chat on your local model, so the cloud is always a choice you make.

Plans and prices as of November 2026, from ollama.com/pricing; Ollama may change them. Local models stay free and unlimited.