Octopi / Visual guide
Type what you want done. Octopi does it for every row.
Octopi is a spreadsheet that works through your list for you: it researches each company on the web, checks your CRM, and writes the answers in new columns with their sources. Here is the whole thing in pictures.
Find the CEO of each companyInstall it once
You need a Mac with Apple silicon and macOS 14 or later. Download Octopi, open the file and drag Octopi to Applications. There's no account to make.
- Keep the model marked Rec. It's picked for your Mac's memory.
- Click Install Chrome only if you sign in to websites with a passkey.
- Click Start. Octopi downloads its AI and a private browser; the model takes the longest.
The AI model runs on your Mac. Research still needs the internet.
Open your list and say what to do for each row
- Open a CSV or Excel file with ⌘O, or drag it onto the window.
- Type the task in the box above the sheet. Write it for one row: "each company".
- Check Plan ▸ under the box. It says if the run writes outside the sheet, like no external writes or writes to HubSpot. Click it to see what it reads, visits and writes.
- Click Run. The arrow beside it offers Run first row only to try it first.
There's no separate Plan button: the plan updates as you type. Stuck for words? While the box is empty, click an example next to Try:.
| Company | Country | Website | |
|---|---|---|---|
| 1 | Logitech | Switzerland | logitech.com |
| 2 | Swatch Group | Switzerland | swatchgroup.com |
| 3 | Alpenrot AG | Switzerland | alpenrot.example |
| 4 | Nordwind Labs | Germany |
New columns appear next to yours, each with its source
Octopi never changes your own columns unless the task names one. Every row also gets a Status, a Confidence score and Notes that say why.
| Company | CEO | CEO Source | Status | Confidence | Notes | |
|---|---|---|---|---|---|---|
| 1 | Logitech | Hanneke Faber | logitech.com/…/leadership | complete | 92 | Named CEO on the company's leadership page |
| 2 | Swatch Group | Nick Hayek | swatchgroup.com/…/management | complete | 90 | Named on the group's management page |
| 3 | Alpenrot AG | uncertain | 40 | Two pages named different people | ||
| 4 | Nordwind Labs | not_found | 0 | No website or page names a CEO |
Done. Each answer has a source page.
Octopi looked and found nothing. That's an answer too.
The sources didn't agree or weren't clear enough.
Stopped on this row. It waits in the review queue.
The two CEO names are real answers from a run on Oct 19. Rows 3 and 4, the scores and the notes are made up to show the other states.
Sign in to your CRM once, in Octopi's browser
Octopi works in Salesforce, HubSpot, Pipedrive, Dynamics 365 and LinkedIn with your normal login. There are no API keys to paste.
- Choose Browser ▸ Open AI Browser.
- Sign in as you usually do, then leave the window open. You can hide it.
- Keep one account open per CRM. With two open, Octopi asks instead of guessing.
Your logins are kept when you quit. Outlook needs one permission in System Settings ▸ Privacy & Security.
Ask, look up and change one thing at a time, by typing or by voice
Use the task box for a whole list. Use the chat for one question, one record or one file. Open it with ⇧⌘C or View ▸ Chat…. Its answers come from the AI model on your Mac.
What's in the chat window
- New Chat starts over (⌘N). The conversation otherwise lasts until you quit.
- Read Aloud speaks each answer as it arrives. Its arrow picks the voice; ⌘. silences it.
- Talk starts a spoken conversation (5e below).
- Suggestions to start with, until you've asked something.
- The paperclip attaches a PDF, Word or text file to ask about. A spreadsheet opens in the sheet instead.
- The microphone types one message from your voice. Return sends it.
Four kinds of question, four kinds of answer
For a look-up, use the record's full name: "Tesla Motors", not "tesla". In one test, the short name said No.
Every change shows a card first
- Say the change in plain words, with the CRM's name.
- A card shows exactly what will change. Nothing has happened yet.
- Confirm makes it. Edit fixes a value first; Cancel drops it.
- Octopi saves the change, then reads it back to check it landed.
"Set" fills an empty field only. "Change", "rename" or "move" replaces what's there.
Tired of confirming? Octopi ▸ Preferences ▸ Chat changes has "Always allow changes" for each CRM. Typed changes then start by themselves, still on a card with Stop. Spoken changes always ask.
Ask for every row, and the chat hands you a task
When you ask about "each company", the chat answers with a task card instead of doing it on the spot.
- Run runs it over your sheet, exactly like the task box.
- Run on selected rows does only the rows you've selected.
- Put in task box lets you read the plan there first.
Emails and LinkedIn invitations are never sent from the chat itself. They come as a task card, and the run asks you once before sending.
Talk: speak, pause, and hear the answer
- Click Talk in the chat. The message box becomes one big circle.
- Speak. Your words appear in large type as you say them.
- Pause. Octopi sends what you said, then reads its answer aloud.
- It listens again by itself, so you can keep going.
Type instead pauses the listening so you can type. End Talk (or Esc) goes back to the normal chat.
The first time, macOS asks to allow the microphone and speech recognition. Your voice is turned into text on your Mac.
The circle shows what Talk is doing. Click it to cut in
It's hearing you. Click when you're done to send right away.
It's working on the answer. Click to stop it and talk.
It's reading the answer aloud. Click to interrupt and talk.
A run you started from the chat: the ring fills row by row, with the company under it.
A spoken change waits for your "yes"
- Say the change. The same card appears as when you type.
- Answer with just "yes" to make it.
- Anything else, such as "no", "yes but…" or a new question, cancels it, and Octopi says so.
A few cards need a click even in Talk, such as completing a task or drafting an email reply. Octopi says "press Confirm".
It speaks five languages in a natural voice
The natural voices come with Octopi and are made on your Mac. Other languages, German included, use the Mac's own voices. Pick a voice from the arrow beside Read Aloud.
On macOS 14 and 15, Talk listens in a language whose Dictation is on: System Settings ▸ Keyboard ▸ Dictation. On macOS 26, Octopi downloads the language itself.
Chat requests that passed in tests
Each one passed our chat tests on a test sheet and test CRM records (October 2026). Swap in your own names.
Search Ollama's library and use any open model
Octopi's AI is an open-source model that runs on your Mac through Ollama, the free model runner. You can swap it for another one. The Models window searches Ollama's whole library, community models included, and downloads the one you pick. The chat, Talk and your runs then use it.
Two ways into the Models window
- Click the model pill at the bottom of the task box. It shows the model and whether it's ready ✓.
- In the chat, click the model's name under Octopi Chat. It ends in ▾.
Both open the same window. Whatever you pick there, the pill and the chat show it.
What's in the Models window
- The model in use, and whether it's ready.
- Installed: every model Ollama has on this Mac, including ones you added yourself. Use switches at once. Remove frees the space; click again on Confirm remove.
- The search. Type a name or what it does: llama, vision, coder.
- Octopi's suggestions. Switch downloads one and starts using it.
The right side of the window is Claude (paid). It stays off unless you turn it on.
Type a name, or what the model should do
- Matches show as you type, four at a time. Type more words to narrow them.
- The words in brackets are what the model can do, as ollama.com lists them. vision means it can read images.
- The menu picks a size. It starts at the size closest to Octopi's standard model, about 4.7 GB. Bigger sizes are smarter, but slower, and need more memory.
Misspelled? It still finds it: deepsek brings up deepseek-r1.
Models people publish on Ollama, marked Community
Besides Ollama's own models, the search finds the ones people and organisations publish under their own name, as publisher/model. Hover a row to read its whole description.
- Their line starts with Community ·, so you know Ollama didn't make them: their publisher did.
- When you click Switch, Octopi checks which versions the model has. If there are several, the row says Pick a version: choose one in its menu, then click Switch again.
The models listed are real search results from ollama.com, read on Nov 11, 2026. What you see may have changed since.
Click Switch: it checks the size, downloads, then it's in use
Before anything downloads, the window says what will happen. If the model you're leaving is one Octopi suggests, it's removed once the new one is in use, so you only need room for one. A model you added yourself is kept.
1 · Checking size
Octopi reads the exact download size from ollama.com, and checks there's room for it.
2 · Downloading
Ollama downloads it onto your Mac. Keep working meanwhile; Cancel stops it.
3 · In use
The new model answers from now on. The window says what it removed and how much space that freed.
Then chat with it, or talk to it
The chat and Talk use the model you picked, on your Mac. Its name is under the chat's title. Press Talk and the same model answers out loud.
The search box's own note: "Octopi is tuned for Qwen 2.5 — another model may plan and read less reliably." For runs over a whole list, Qwen 2.5 is the safe choice.
What the search sends, and what it leaves out
Choose how much Octopi asks before it changes things
Pick a mode in the Run menu, or click the label at the bottom of the task box.
Dry Run
Changes nothing in other apps. Results still fill the sheet.
Careful
Asks before each new kind of change, and checks the first row.
Trusted
Like Careful, until the task has run cleanly once.
Unattended
Makes ordinary changes without asking.
Fix the stuck rows, then finish the list
Open the queue
View ▸ Review Queue… lists each stuck row and why.
Fix what it asks
Fill in a missing value, or sign in again.
Retry
Retry reruns that row. Skip takes it off the list.
Finish the rest
Run ▸ Run Unfinished Rows leaves the done rows alone.
To stop a run, click Stop (where Run was) or press ⌘.. Rows already done keep their answers.
Tasks that worked in real runs
Each one finished in our own runs of Octopi. Change the subject or date to yours.