Octopi / Visual guide

Octopi for Mac · 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.

Open your listCompanies or people, one per row.
Type the taskFind the CEO of each company
Click RunOctopi plans, then goes row by row.
It does the workThe web, your CRM, Outlook, LinkedIn.
Read the answersNew columns, each with its source.

Also in: Français Deutsch

Step 1 · install

Install 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.

Free · macOS 14+ · Apple silicon
  1. Keep the model marked Rec. It's picked for your Mac's memory.
  2. Click Install Chrome only if you sign in to websites with a passkey.
  3. 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.

Step 2 · the task

Open your list and say what to do for each row

  1. Open a CSV or Excel file with ⌘O, or drag it onto the window.
  2. Type the task in the box above the sheet. Write it for one row: "each company".
  3. 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.
  4. 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:.

Step 3 · the answers

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.

complete

Done. Each answer has a source page.

not_found

Octopi looked and found nothing. That's an answer too.

uncertain

The sources didn't agree or weren't clear enough.

needs review

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.

Step 4 · your tools

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.

  1. Choose Browser ▸ Open AI Browser.
  2. Sign in as you usually do, then leave the window open. You can hide it.
  3. 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.

Step 5 · the chat and Talk

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.

5a · the window

What's in the chat window

  1. New Chat starts over (⌘N). The conversation otherwise lasts until you quit.
  2. Read Aloud speaks each answer as it arrives. Its arrow picks the voice; ⌘. silences it.
  3. Talk starts a spoken conversation (5e below).
  4. Suggestions to start with, until you've asked something.
  5. The paperclip attaches a PDF, Word or text file to ask about. A spreadsheet opens in the sheet instead.
  6. The microphone types one message from your voice. Return sends it.
5b · what you can ask

Four kinds of question, four kinds of answer

Your sheetCounts, totals, which rows
A chartFrom the open sheet
Your CRMName no CRM to search them all
A fileRead on your Mac

For a look-up, use the record's full name: "Tesla Motors", not "tesla". In one test, the short name said No.

5c · changing a record

Every change shows a card first

  1. Say the change in plain words, with the CRM's name.
  2. A card shows exactly what will change. Nothing has happened yet.
  3. Confirm makes it. Edit fixes a value first; Cancel drops it.
  4. 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.

5d · from chat to the whole list

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.

  1. Run runs it over your sheet, exactly like the task box.
  2. Run on selected rows does only the rows you've selected.
  3. 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.

5e · Talk

Talk: speak, pause, and hear the answer

  1. Click Talk in the chat. The message box becomes one big circle.
  2. Speak. Your words appear in large type as you say them.
  3. Pause. Octopi sends what you said, then reads its answer aloud.
  4. 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.

5f · the circle

The circle shows what Talk is doing. Click it to cut in

Listening

It's hearing you. Click when you're done to send right away.

Thinking

It's working on the answer. Click to stop it and talk.

Speaking

It's reading the answer aloud. Click to interrupt and talk.

Working

A run you started from the chat: the ring fills row by row, with the company under it.

5g · changes by voice

A spoken change waits for your "yes"

  1. Say the change. The same card appears as when you type.
  2. Answer with just "yes" to make it.
  3. 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".

5h · voices and languages

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.

EnglishHeart
FrenchSiwis
ItalianSara
Spanish · PortugueseDora
German and othersMac voicesThe best one installed for each language
5i · ready to say or type

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.

Your sheet
Which companies are in Switzerland?
Answered from the open sheet
Your sheet
What is the total revenue in CHF m?
Total checked: right
A chart
Chart the revenue by company
A chart card came back
A file
What is the monthly fee in the agreement?
With the PDF attached: right amount
Any CRM
Is <company> in my CRM?
Searched every connected CRM
A row
Is the company in row 3 in HubSpot?
Answered for that row
The web
Who is the CEO of Logitech?
Hanneke Faber, from logitech.com: right
HubSpot
Add a task '<subject>' to <company> in HubSpot due 2026-11-03 with priority High
Saved and read back
HubSpot
Set the number of employees of <company> to 120 in HubSpot
Saved and read back
Pipedrive
Add <company> to Pipedrive as an organization
Saved and read back
Dynamics 365
Mark the task '<subject>' as done in Dynamics 365 for <company>
Passed in our tests
Whole sheet
Check if each company is in HubSpot
Task card, then ran over the sheet
Step 6 · open-source models

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.

6a · open it

Two ways into the Models window

  1. Click the model pill at the bottom of the task box. It shows the model and whether it's ready ✓.
  2. 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.

6b · the window

What's in the Models window

  1. The model in use, and whether it's ready.
  2. 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.
  3. The search. Type a name or what it does: llama, vision, coder.
  4. 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.

6c · search

Type a name, or what the model should do

  1. Matches show as you type, four at a time. Type more words to narrow them.
  2. The words in brackets are what the model can do, as ollama.com lists them. vision means it can read images.
  3. 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.

6d · community models

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.

  1. Their line starts with Community ·, so you know Ollama didn't make them: their publisher did.
  2. 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.

6e · switch

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.

Not enough spaceThe button says so, with how much is free. Remove a model, or free some space.
Download failedThe row reads "Download failed — is Ollama running? Then Retry." Nothing was removed.
Going backClick Use if it's still installed. If it was removed, Switch to it again and it downloads again.
During a runThe old model is kept while a run is using it. Remove it once the run finishes.
6f · use it

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.

6g · what goes where

What the search sends, and what it leaves out

Only the words you typeThe search sends the words in the box to ollama.com, nothing else of yours. Octopi reads Ollama's list of models at most once a day.
Downloaded once, then localOllama downloads the model onto your Mac. From then on it runs there.
No cloud-only modelsModels that run only in Ollama's cloud aren't offered: they would send your chat off your Mac. Embedding models, which can't chat, aren't either.
Step 7 · how careful it is

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.

default

Unattended

Makes ordinary changes without asking.

In every mode, Octopi asks once before it sends emails or LinkedIn invitations. It shows how many and the first one in full, and goes ahead only when you press Allow for this run, including ⚠.
When a row gets stuck

Fix the stuck rows, then finish the list

1

Open the queue

View ▸ Review Queue… lists each stuck row and why.

2

Fix what it asks

Fill in a missing value, or sign in again.

3

Retry

Retry reruns that row. Skip takes it off the list.

4

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.

Ready to copy

Tasks that worked in real runs

Each one finished in our own runs of Octopi. Change the subject or date to yours.

Find websites
find the website of each company
14 of 14 rows done
Find a CEO
Find the CEO of each company
Logitech and Swatch Group both right
Swiss register
Search each company on zefix.ch and check if it is registered in Switzerland; note the registered name and canton.
The built-in demo: 6 of 6 right
Is it in Salesforce?
check if the company is in salesforce and get the owner of the account
242 of 247 rows done
Add to Salesforce
add the company and contacts to salesforce
Added and read back, no duplicates
Is it in HubSpot?
For each company, find its official website and check whether it's already in HubSpot
Right in live runs on 0.22.2
Pipedrive task
add a task 'Intro call' in Pipedrive for each company and link the contact to it
Passed every live test, Oct 4–7
LinkedIn schools
Look up each person on LinkedIn Sales Navigator and check their school section to find Swiss schools.
171 of 193 profiles read
Safety

What Octopi won't do

Overwrite your columnsUnless the task names one as the place to write.
Send without askingEmails and invitations wait for your OK, once per run.
Delete CRM recordsIt adds and updates. It can't delete.
Make duplicatesIt checks for an existing record first, and reads each change back.
Send a replyEmail replies are only drafted, never sent.
Send your sheet to the cloudThe AI runs on your Mac. Claude is used only if you turn it on.