Homunculus Download for Mac

Notes you can talk to.

Homunculus keeps your notes as plain files in a folder you choose. Ask the assistant a question and it reads, searches and links them, and the conversation is saved as a note beside the rest.

Download for Mac

For Macs with Apple silicon, macOS 11 or later.

Chats/Kidney stones.md
---
type: chat
assistant: "[[Homunculus]]"
---

- User -
Which of my notes cover kidney stones, and what
do they say about prevention?

- Assistant -
Three notes cover them: [[Nephrolithiasis]],
[[Hypercalciuria]] and [[Thiazide diuretics]].

For prevention they agree on fluids (urine
output over 2.5 L a day) and a normal-calcium,
low-sodium diet. [[Thiazide diuretics]] adds
that thiazides lower urinary calcium.

Your files, in your folder

Every note is a markdown file you can open in any editor, back up, or sync with iCloud Drive. Links like [[Nephrolithiasis]] work across the whole folder.

An assistant that works in your notes

It can search, read, write and reorganize notes, run commands you write yourself, and read PDFs page by page. Bring your own Anthropic or OpenAI key.

Study what you write

Turn notes into flashcards and review them on a spaced schedule, with progress shown for each deck.

On your phone

iPhone and iPad apps are on the way. Until then, your Mac can serve the app to your phone over Tailscale, a free private network that only your devices can join.

  1. Install Tailscale

    Install it on your Mac and your phone from tailscale.com/download, and sign in to the same account on both.

  2. Turn on Phone access

    In Homunculus, open Settings → Phone access and turn on Use Homunculus from my phone. Follow its steps to save your Mac's address and turn on the private link.

  3. Pair your phone

    Click Pair a device and scan the code with your phone's camera. Then use Share → Add to Home Screen so it opens like an app.

Your Mac needs to be awake with Homunculus open. Turn on Open at login in the same section so it's always there.