Meru मेरु
A personal AI assistant that runs on your own Mac.
In some Eastern traditions, Meru is the cosmic mountain that the sun, moon and stars turn around.
v0.8.0 · November 2026 · aarora79.github.io/meru
github.com/aarora79/meru
Scan for the code
The question
An assistant helps most with the things you'd least like to hand over
- Your mail, notes, files and photos are what a question like "when is the dentist?" or "what did I decide about the garden?" needs.
- A hosted assistant reads them on its provider's servers, under terms you don't set and that can change.
- Meru runs on your Mac. Open-weight models answer there, beside your data, and nothing you ask goes to a model provider.
What you use
Meru.app, a desktop app on your Mac
- Ask across your own things: folders, Gmail and Google Calendar, notes in Obsidian or Apple Notes, GitHub or Slack, and the web.
- Attach a file or picture, or press the microphone and speak.
- Pick where it looks: Auto, My files, Mail and calendar, Web, or Just talk.
- File, tag and search your chats, or start an incognito one.
The app talks to merud, a program on your Mac that runs the models through a local model server, Ollama today, and keeps your data. meru chat gives you the same in a terminal.
What it does
Questions it answers from your own things
Your files
Searches the folders you choose, Markdown, PDFs, HTML and code, and cites the file and line it used.
Your mail and calendar
Searches Gmail with its own search words and opens attachments. Reads Calendar and Drive, and asks before it sends or changes anything.
Your notes
Searches Obsidian, and reads Apple Notes live and read-only.
Your pictures
Finds pictures in your folders by words, or like one you attach, and a model that can see reads them.
The web
Searches through a search engine on your Mac, reads pages, and cites the address.
Writing
Saves notes, drafts and pages into ~/meru-output. A card or poster you ask for carries your own photo.
It learns
An assistant that remembers who you are, in files you can read
- Memories are Markdown files in
~/.meru/memory/, one per fact, in folders such asme,people,projectsandpreferences. What you tell it about yourself goes into every prompt. - You see and change them in Settings, About you, or with
/me; forget one with a key press, or delete the file. - Past chats help later ones. Meru summarizes a chat once it goes quiet, and finds earlier chats that bear on a new question.
- Skills teach it how to do a task: plain writing, explainer pages, and research on the web, your files or your mail ship with it, and you can add your own.
Privacy
What leaves your Mac
| Data | Where it goes |
|---|---|
| Your questions and Meru's answers | Nowhere: the models run on your Mac, unless you name one on your own network and say yes for that chat. |
| Your files, notes and pictures | Indexed into a file on your Mac and read there. |
| Telemetry, crash reports, update checks | One anonymous count a day, with no ID and no text, which you can turn off. No crash reports and no update checks, ever. |
| Web searches | The search words go to the engines your own SearXNG asks. |
| Web pages | Public addresses only. Meru asks first for an address no search or question of yours gave, unless you trusted that website. |
| Mail, calendar, GitHub, Slack | Read through your own accounts, when you connect them. A sign-in token stays in a file on your Mac only you can read. |
| Your voice | Turned into text on your Mac by Whisper; no recording is kept. |
You decide
You stay in charge of what it does
Before it acts
- Each tool is Off, Ask or Allow.
- Sending, deleting or changing asks you on a card, every time; you can edit the request first.
- Reading a website you didn't ask about asks too, or you trust that site for the chat or always.
After
- Every tool call is in a log you can read:
/log, or Settings, Activity. - Chats are plain files in
~/.meru/sessions; delete one and it's gone. - An incognito chat leaves no transcript.
- Meru hides your saved keys in its log and in server errors.
Which Mac
Answer quality and speed by Mac memory
| Mac memory | Answer model | Passed | First word, median | Whole answer, median |
|---|---|---|---|---|
| under 32 GB | MiniCPM5-2B | 68% | 11.6 s | 13.1 s |
| 32 to 47 GB | gemma4:26b-a4b-it-qat | 80% | 17.6 s | 18.3 s |
| 48 to 63 GB | qwen3.6:35b | 89% | 5.6 s | 10.4 s |
| 64 GB or more | qwen3.6:35b-a3b-mxfp8 | 89% | 4.1 s | 6.5 s |
The installer picks the model for your Mac's memory. 150 results per model set, 3 runs of 50 questions about the author's own files, notes, mail and calendar, which aren't published; your numbers will differ. Times include searching and tool calls. Source: docs/benchmarks/results.md, 28 September 2026.
Getting started
On your Mac in a few minutes
- Download the Mac installer from the latest release, open the disk image, and open "Install Meru.app". It sets up the model server and the models for your Mac, web search, the folders Meru reads, and
merud, step by step in a window. - Or use one line in a terminal:
curl -fsSL https://github.com/aarora79/meru/releases/latest/download/install.sh | bash - Then connect what you want in Settings, Connections: Google, Obsidian, Apple Notes, speech to text. Each is off until you turn it on. GitHub or Slack takes one click on Sign in.
Macs with Apple silicon. On Ubuntu, install-linux.sh does the same in a terminal, and on Windows install.ps1 in PowerShell. Web search runs in Docker or Podman. Meru never checks for updates; run the installer again for a new release, and it keeps your settings and memories.
Day to day
Small things that add up
Speak
Press the microphone, speak for up to a minute, and check the words before you send them.
Continue
An answer that stops short gets a Continue button that picks up where it stopped.
Long reading
A question can read dozens of web pages; Meru sizes the model's working memory for your Mac.
Quick replies
With routing on, the fast model takes greetings and rewording, and starts sooner. Ask the large model when you want more.
Usage
A Usage screen charts your questions, answer times and tool calls, from data on your Mac.
Jobs
Meru asks a question or runs a skill on a schedule, such as every weekday at 7, and files each run as a chat.
How it compares
What you get with Meru, Muse or OpenClaw
Meru
- Private by construction. Models run on your Mac, and no question leaves it unless you name a model on your own network and say yes.
- No account, no subscription, no bill per question. It works offline once the models are down.
- Answers from your own things, with the files cited: folders, mail, calendar, Obsidian, Apple Notes, pictures and the web.
- Memories you can read: one Markdown file per fact, to fix or delete.
- Asks before it sends, deletes or changes, logs every tool call, and flags a claimed action no tool took, or an amount nothing it read holds.
- Your voice and pictures stay on your Mac.
Muse, from Meta
Good at
- Errands on the web: browsing, forms, bookings, payments through partners
- Meta's newest models, on phone, web and glasses
You give up
- Your agent and data live in Meta's cloud
- Chats train Meta's models unless you opt out
- $20 or $100 a month past the free tier; US only
OpenClaw
Good at
- Reaching you in WhatsApp, Telegram, Slack and 20 more chat apps
- Any model, and broad control of your computer
You take on
- A hosted model sees your questions unless you run a local one
- Commands run on your computer; the sandbox is off by default
- Vetting each skill: Cisco found ones that sent data out
As of October 2026. Sources: about.fb.com/news/2026/09/introducing-muse-personal-ai-agent; en.wikipedia.org/wiki/Muse_(AI_agent); github.com/openclaw/openclaw; blogs.cisco.com/ai/personal-ai-agents-like-openclaw-are-a-security-nightmare.
Honest limits
What Meru does not do yet
By design
- No phone app, no account, no sync between machines
- One person per machine
- No cloud model to fall back on; a larger model on your Mac or network answers only when you ask
Not yet
- Pre-alpha, v0.8.0
- Slower than a hosted assistant: the first word takes 4 to 18 seconds
- Digests and notifications are still to come
- macOS first; Ubuntu and Windows with their own installers
Under the hood
Everything inside the dashed line runs on your Mac
The models, your data, the search index, your chats and memories. Only the tools you allow reach outside.
Under the hood
What happens when you ask
- Meru looks first in your files and memories. A question about your own life also checks your notes and mail.
- The model on your Mac reads the question with what Meru found, and writes the answer.
- The model never calls a tool itself. It asks Meru, and Meru asks you first when the tool would send or change something.
- The answer arrives word by word, with the files it used. An amount nothing Meru read backs gets a note.
Built in the open
Free and open source, under the Apache License 2.0.
We're happy to take contributions: see the issue list. Ideas and bug reports start there too.
github.com/aarora79/meru · aarora79.github.io/meru
github.com/aarora79/meru
Scan for the code