Help
How can we help?
Answers for the people who use Twoody today: installing it, choosing a model, your documents, walled-off projects, the iPhone app, the account, and what to do when something does not work.
Install and first launch
How do I install Twoody on a Mac?
Twoody is in private beta: the page with the installers is sent to the people invited. Take the version for your Mac, Apple Silicon or Intel, open the .dmg file and drag Twoody into Applications. It needs macOS 13.3 or later; the app is notarized by Apple, so it opens like any other. Not invited yet? Join the waitlist.
How do I install Twoody on Windows?
With the installer from the private beta's page: run it, choose the folder, and Twoody installs for your user only. It runs on Windows 10 and 11 (64-bit), on an Intel or AMD processor; the installer is signed by Osmove.
How do I install Twoody on Linux?
The private beta's page offers two packages for x86_64: the AppImage, which runs on most distributions (make it executable, then open it), and the .deb package for Debian, Ubuntu and their derivatives, installed with your package manager. Twoody is tested on Ubuntu 24.04; the model runs on the processor.
What happens the first time I open Twoody?
Twoody asks what it should do for you (memory, documents, contacts, agenda, dictation): turn on what you want now, or later in Capabilities. Then it offers a model sized for your computer: click “Install”. The model is downloaded once from Hugging Face, about 3.5 GB for Qwen3.5 4B and 6.7 GB for Qwen3.5 9B, and checked before use; after that, Twoody answers without the internet. No account is asked for.
Which model should I choose for my computer?
The one Twoody suggests when it installs, depending on your computer: on a Mac with Apple silicon, Qwen3.5 9B from 16 GB of memory, Qwen3.5 4B below. On an Intel Mac, on Windows and on Linux, where speed depends on the processor and the graphics card, it suggests 4B, and 9B from 32 GB, or, on Windows, from 16 GB with a graphics card that has 10 GB of memory of its own. From 24 GB, it also offers the larger Qwen3.6 35B-A3B. You can always choose another one in the catalogue of Models. To see what models a computer can run, and how fast, try the local LLM calculator.
Does Twoody work on a Mac with 8 GB of memory?
Yes: Twoody suggests Qwen3.5 4B there, which needs 4 GB of memory (3.5 GB to download). When memory is short, Twoody does not load the model in advance: your first question loads it, so it takes longer. Closing heavy apps helps; on an Intel Mac, the model runs on the processor, more slowly.
Choosing a model
How do I choose another model?
Open Models: “In use” shows the model that answers, “Installed” the ones on this computer, and the “Catalogue” offers 57 (Qwen, GLM, DeepSeek, Gemma, Mistral, Llama, Phi, gpt-oss, Nemotron and others), verified on Hugging Face. Search by name, family or use (Code, Reasoning, Images, Small and fast); each model says the memory it needs, its download size, its licence and what it can do (“reads images”, “uses tools”). Click “Install”: the model is downloaded from Hugging Face, each file is checked against its fingerprint (SHA-256) before use, and the conversation moves to that model. Those marked “measured by Twoody” were tried with its memory, its tools and your documents; the others are offered as they are.
What does “needs … of memory” mean?
It is the memory the model takes when Twoody runs it on this computer: the model itself, the conversation's memory (its context window, larger on a computer with more memory), the engine's work buffers and, for a model that reads images, what it needs to read them. The “Fits in this computer’s memory” filter, ticked from the start, shows only the models that fit there next to your other apps. Untick it to see them all: a model too heavy is marked “too large for …”, and Twoody warns you before installing it, as it may answer very slowly and slow down your other apps. For another computer, the local LLM calculator makes the same calculation.
What does “licence with conditions” mean?
Each model keeps its publisher's licence, shown in the catalogue. Most are under Apache 2.0 or MIT, open licences. Eight of the 57 carry “licence with conditions”: Llama (Meta), Nemotron (NVIDIA), LFM2.5 (Liquid AI) and DeepSeek-Coder-V2 Lite. Their licence sets its own terms of use: “Read the licence” opens it at its publisher; read it before installing the model, especially for professional use.
How do I switch from one model to another, or remove one?
In Models › “Installed”, click “Use”, or pick the model under the conversation. One model is in memory at a time: choosing another releases the previous one. Twoody shows “Loading…”, then “Preparing…” (it reads ahead the start of a conversation with that model), then “Ready”: the first answer then comes quickly. “Remove” (the bin icon) takes off a model that is not in use; you can install it again. On the iPhone, the list of models shows the ones installed on your computer, with each one's memory, and you switch from one to another; to install a new one, open Models on the computer.
How much disk space do the models take?
From 0.8 GB for the smallest, Qwen3.5 0.8B, to 43 GB for the largest, Llama 3.3 70B; Qwen3.5 4B takes 3.5 GB and Qwen3.5 9B 6.7 GB, with their file for reading images. The catalogue gives each one's download size, Twoody checks the free space before it starts, and an interrupted download resumes where it stopped. On a Mac with Apple silicon, a model's MLX version is a separate download of a similar size: the same model installed for llama.cpp and for MLX takes twice the space. The models are kept in Twoody's data folder, with your conversations; “Remove” frees their space.
Can I use a model that runs in another app?
Yes, if that app serves it on your computer or your network the way OpenAI does (an “OpenAI-compatible” server): Twoody finds the most common ones on your computer by itself. In Models › “Advanced” › “Engine”, choose the engine Twoody uses first, or “Other address” to give a server of your computer or your network; with “Automatic”, it is the first one that has a model, starting with Twoody's own (llama.cpp).
MLX on the Mac
What is MLX, and should I install it?
MLX is Apple's engine for Macs with Apple silicon, often faster than llama.cpp on those Macs: about a quarter faster on a recent MacBook Air, measured by Twoody with Qwen3.5 9B. It is optional: llama.cpp stays the default engine, and the only one on Windows, on Linux and on an Intel Mac. MLX needs macOS 14 Sonoma or later; Twoody installs it only if you ask, and never picks it for you. Its limits: MLX models do not read images, and Twoody's memory, tools and documents were measured with llama.cpp first.
How do I install MLX?
In Models › “Advanced”, click “Install MLX”: Twoody downloads a Python of its own from its release on GitHub and MLX's packages from PyPI, checks each against its SHA-256 before using it, then runs MLX itself, with no Terminal and no other app. It needs about 1.3 GB free on the disk; MLX then takes about 500 MB. The catalogue then offers “For MLX” next to “Install” for 53 of the 57 models: their MLX version is downloaded from Hugging Face, checked like the others, and the conversation moves to it.
Why does Twoody ask me before sending an image to an MLX model?
Because MLX models do not read images. Before a message with an image leaves, Twoody tells you which llama.cpp model of your computer will read it for this answer — the llama.cpp version of the same model if it is installed, else another model that reads images — with “Send” and “Cancel”: nothing leaves before “Send”. Under the answer, Twoody says it again: “The image was read by … (llama.cpp)”. If none of your llama.cpp models reads images, install one in Models (those that can are marked “reads images”). The iPhone app asks you the same way before sending a photo when your computer answers with MLX.
How do I go back to llama.cpp?
In Models › “Installed”, each model carries the name of its engine, llama.cpp or MLX: click “Use” on a llama.cpp model. If you had chosen MLX under “Advanced” › “Engine”, choose “Built-in (llama.cpp)” or “Automatic” there. One model is in memory at a time, whatever the engine: MLX's is released. “Remove” takes off an MLX model and frees its space; with no MLX model installed, MLX does not start.
Documents
How do I give Twoody my documents?
Open Documents and click “Add a folder”, or pick one under “Add quickly” (Downloads, Desktop, Documents…). Twoody reads the files where they are, on your computer: nothing is copied elsewhere. You can also attach a file to a message. “Stop reading this folder” deletes its index; your files are not touched.
When does Twoody read my documents?
Only when they help. When your message clearly speaks of them (a file or a folder named, a contract, an invoice, a list of files), Twoody searches them before answering; otherwise the model searches them only if the question needs it. Under the message, “Tools” › Documents lets you choose all authorized folders, some of them, or none. Twoody indexes your folders when it starts and with “Check for changes”.
How do I know where an answer comes from?
An answer drawn from your documents lists its “Sources”, numbered: click one to open the file at the page, the slide or the rows it cites. A model can still be wrong, even when it cites its sources: check what matters.
Does Twoody read scanned PDFs?
On a Mac, yes: a scanned PDF is read by macOS character recognition (OCR), on the Mac, up to 300 pages. On Windows and Linux, not yet: only PDFs that contain text are read.
Which files can Twoody read?
PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), OpenDocument (.odt, .ods, .odp), RTF, CSV, plain text, Markdown, HTML and a few others, up to 20,000 files per folder. Not yet: the old .doc, .xls and .ppt formats.
Memory
What does Twoody remember about me?
What is worth keeping from what you say, never from your documents or from web pages. It reads your conversation again in the background, and “Memory saved” appears in the chat. What it is unsure of, or what is sensitive (health, money, beliefs, legal matters, identity, address), waits in “To confirm” until you decide. An ephemeral conversation is never read.
How do I make Twoody remember something right away?
Say it: “Remember that the school is closed on Wednesdays.” Twoody keeps it at once and shows “Memory saved”, or “Already in memory”. You can also write one yourself in Memory, with “New memory”.
How do I see, correct or delete what Twoody remembers?
Open Memory: each memory can be edited or deleted, several at once with “Select”. “To confirm” lists what waits for your decision (a memory you refuse is not proposed again), and “Possible duplicates” offers to merge memories that say the same thing. To stop memory altogether, turn Memory off in Capabilities: nothing is then remembered or learned.
Walled-off projects
What is a walled-off project?
A project whose documents, conversations and notes stay apart: they are used in this project only, and nothing else comes in. For a client's file at a law or accounting firm, for instance. In Projects › “New project”, tick “Wall off this project”, then choose “Its documents folder”, now or later. That folder is read in the project's conversations only: not in your other conversations, not in another project, not by your other computers, not by the people you share a folder with, even if a folder you share holds it. Its conversations are never learned into your Memory nor put into your encrypted history, and the diagnostics shared hold nothing of them. Only a model of your computer, or of one of your trusted computers, answers there, never a cloud model. The project and its conversations are marked “Walled off”.
Can I wall off a project I already made?
No: “Wall off this project” is chosen when the project is made, never afterwards. What Twoody has already learned from an ordinary project's conversations (memories, people, cards) would stay outside, and the wall would not keep its promise. Make a new walled-off project and give it its folder. A walled-off project stays walled off.
What happens to “Remember that…” in a walled-off project, and what is off there?
“Remember that…” becomes a note of the project there, never a memory: the notes, on the project's page, are its own memory, with its “Summary”, given to Twoody in each of its conversations. Of your Memory, it gets only what you wrote or pinned yourself and how you like answers. Agenda, contacts, bank, home, connectors and the internet stay off there: in “Tools”, you can turn one on for this conversation only, from the computer, and that choice is not kept. The Agent is not offered there.
How do I export or archive a walled-off project?
On the computer, on the project's page: “Export…” writes, in the folder you choose, a new folder of Markdown files — the project's summary, its notes, the list of its documents and each of its conversations; the documents themselves stay in their folder. “Archive” closes it: its conversations can be read and exported, but not continued, until “Reopen”. “Delete this project” is possible only for a project still empty: archive it instead.
Can I open a walled-off project from the iPhone?
Yes, from your own iPhone, paired with the computer that keeps the project: in Projects, it is marked “Walled off”. You read and continue its conversations, start one, and add notes. Each exchange is encrypted end to end with that computer only, directly on the local network or through the account's relay, which passes on sealed messages only; nothing of it is kept on the iPhone. The answer shows word by word, as the computer writes it, and a cited source shows its file's name, which opens on the computer. Making a project, choosing its folder, exporting it, archiving it, or turning on the internet or connectors there is done on the computer. A household member's device never reaches it. If the iPhone does not open it, open “Tools”: it says why.
What is not walled off?
Twoody Code and the Agent can open your firm's general folder, which holds walled-off projects' folders: those folders stay invisible to them, and Twoody says so once in the session. The Agent never opens a walled-off project's folder; Twoody Code only once you turn on “Allow Twoody Code in this project” on the project's page (off by default), on the computer, never from the iPhone. The commands you allow in Twoody Code run in a sandbox: macOS's on a Mac, bubblewrap on Linux (to install: without it, no command runs while a walled-off project exists); on Windows, no command runs while a walled-off project exists. They read neither the other walled-off projects nor Twoody's data, and write only in the opened folder. What stays outside the walls: a program already running outside Twoody that would act for a command (an SSH server, Docker over the network, an editor); what a command leaves in the folder and you run yourself afterwards; what a command allowed in a project sends over the internet; and your files themselves, ordinary files that your other apps can open: the wall is about what Twoody does with them.
Tools under the message
What is the “Tools” button under the message?
It shows what Twoody may use for your next messages, with a count such as 3/8: Documents, Memory, Contacts, Agenda, Bank, Home, Web search and your connectors, each with its switch, and an arrow to manage it. Your choices are kept for your next conversations.
Why does Twoody not use my agenda, my contacts or the web?
Because each capability stays off until you turn it on, in Capabilities; only Memory is on from the start. A capability that is on appears under “Tools”, where you can leave it out of the next messages; Web search starts off there too.
Work in your folders
What does “Work in your folders” do?
Ask in the chat: “sort my invoices by month”, “rename these scans with their date”, “make me a Word document with the notice periods of my contracts”, “compare these two contracts and make an Excel table”. Twoody answers with what it proposes, file by file: where each file goes and by which date (the one written in the document, else the file's own), or the document it will create and the ones it will read. It acts only when you click “Do it” or answer “yes”. A Word or Excel document is written by your computer's model from the folder's documents; the rest is done by Twoody itself. It is off by default: switch on “Work in your folders” in Capabilities, or under the message in “Tools”.
Can Twoody delete or replace my files?
No. It never deletes a file: asked to, it refuses and offers to move them into a folder instead. A new document never takes the name of an existing file (“Notice periods (2).docx”), and a file is never moved onto another. It acts only in the folders added to Documents, never in a walled-off project's folder nor from a walled-off conversation. After a sort or a rename, “Undo” puts each file back where it was; on the computer, “Open” shows what was created or moved.
Can I ask from the iPhone?
Yes, when “Work in your folders” is on on the computer: the iPhone shows the proposal, and you agree to it on that iPhone, the one that asked, or in Twoody on the computer. The work is done on the computer, where the files open; no other device, and no device of a member of your household, can agree in your place.
Connectors and approvals
What is a connector, and how do I add one?
A connector lets Twoody use another service, such as Notion, GitHub, Linear, Asana or Stripe, through the MCP standard. In Capabilities › Connectors, pick one of the 63 “Suggested connectors”, or “Add a connector” of your own (a command or an https address), and sign in on the service's own page when it asks. You choose which of its tools the chat may use.
Why does Twoody ask before using a connector?
Because a connector sends data to another service. Each call waits for your approval, on the device that asked the question, your computer or your iPhone, and shows what the tool will be given: “Allow” lets this call through, “Always allow” lets this tool through from then on (undone in Capabilities › Connectors), “Refuse” stops it. Without an answer within two minutes, the call is refused.
Agenda, Contacts, Bank and Home
Can Twoody read my agenda and my contacts?
On a Mac, yes, once you allow it: “Add my Mac's calendar” and “Add my Mac's contacts” read them with macOS's permission, and never change them. On every computer, you can also link an Outlook.com or Microsoft 365 account, or add events and contacts yourself in Twoody.
What does Bank do?
It reads the statements you give it, CSV, OFX, QFX or QIF files exported from your bank, so that you can ask about your accounts and your spending. Twoody connects to no bank and moves no money: it only reads these files, on your computer.
Can Twoody control my home?
With Home Assistant, yes. In Capabilities › Home, give the “Address of Home Assistant” and a “Long-lived access token”, then say “turn on the living room light”, or “set it to 30%”. Twoody switches lights, switches, fans, covers, scenes, heating and media players; it never touches locks, alarms or garage doors.
Can Twoody search the web?
If you turn it on: Web search is off by default. Your search then goes to the engine chosen in Settings › Web search (DuckDuckGo by default, Brave Search, or your own SearXNG server), and the pages found are read by your computer. With “Documents only”, Twoody does not go on the internet.
The iPhone app
Does the iPhone app work without my computer?
It is a companion of your computer, in private beta, on invitation: your questions go to the model running on your computer, so you get the answers of a much larger model than a phone could run, with your documents and your memories. It needs Twoody on your computer and a Twoody account. On an iPhone with Apple Intelligence, it can also answer on the phone itself.
How do I pair the iPhone with my computer?
On the computer, open Devices: under “Your other devices”, choose “To devices on the local network”. Twoody shows a QR code: scan it with the iPhone's Camera app, and the app offers to connect. You can also “Type the code instead”. If your computer is signed in to the same Twoody account, the iPhone also lists it under “Your Twoody computers”, and the computer asks you to allow it. With a Twoody account, Devices › “Add a device” › “An iPhone or a browser” also shows a code to scan: the iPhone, signed in to the same account, then gets your encrypted history.
Can I use the iPhone away from home?
Yes, with the Twoody account on the computer: in Devices, choose “From the internet”. Your exchanges then go through the account's relay, sealed with keys only your devices hold: the relay does not have them; it sees that your devices talk, when and how much. The computer must be on and awake, with Twoody open.
How do I report an answer that is wrong or harmful?
In the iPhone app as on the computer, the ⋮ button next to an answer offers “Report this answer”: choose what is wrong (Offensive, Wrong, Dangerous or Other) and, if you want, write a comment. Sent to the Twoody team, through your account: the category, your comment and the name of the model that answered. The answer's text is included only if you tick “Include the reported answer”, unticked from the start; never your question or the rest of the conversation. If the account does not answer, the app offers to send it by e-mail. On a computer without an account, your mail app opens with the report.
The Twoody account
Do I need a Twoody account?
No: Twoody on your computer works without one. The account is free and optional; it links your devices: it is needed for the iPhone app, to reach your computer away from home, to bring several computers together, and for a household, an organization or a shared folder. On the computer: Settings › Account › “Sign in or create an account”.
What does the account see?
Your e-mail address, your devices (name, system, version, public keys), your household and your organizations. The conversations you keep on it, the relay between your devices and the requests for a shared folder are encrypted end to end on your devices: Osmove holds no key that can read them. The conversations kept on the account before this encrypted history stay readable there until you erase them. An ephemeral conversation keeps nothing. Details: the online account's privacy policy.
Privacy
What leaves my computer?
Your conversations, your memories and the index of your documents are kept, encrypted, in Twoody's data folder on your computer (on Linux, when a key manager is available). What leaves it depends on what you turn on: web search sends your search, a connector gets what you allow, models are downloaded from Hugging Face (and, if you install MLX, Python from GitHub and its packages from PyPI), and Twoody checks for updates on downloads.twoody.com. During the beta, technical diagnostics (durations, model, errors; without your questions, answers, documents or file names) are shared by default: untick “Share technical diagnostics with twoody.com” in Settings › Privacy. The box “Also share the whole of each answer”, unticked by default, sends whole answers if you tick it. Cloud models (ChatGPT, Claude) are offered only to the accounts Osmove turns them on for, today its team: marked as such and never picked for you, they receive the conversation only, which then goes through the account without end-to-end encryption. Everything is listed in the privacy policy.
Is my data encrypted on my computer?
Yes, since Twoody 0.13.99: your conversations, your memories, the index of your documents, your contacts and events, your bank statements and the diagnostic traces are kept in an encrypted database (AES-256, in the SQLCipher 4 format), as are the tokens of connectors and the sessions of the Agent and Twoody Code. The key is drawn at random on your computer and kept by the system: the keychain on a Mac, your user account on Windows, GNOME Keyring or KWallet on Linux. Your documents and the models stay your files, where they are. At the first launch of that version, Twoody encrypts your data once and for all, in about a minute per gigabyte (“Encrypting your data on this computer…”). On Linux without a key manager, the database stays in clear, and Twoody tells you how to turn one on: it is encrypted at the first launch that finds one.
The Mac asks whether Twoody may use “Twoody Safe Storage”.
That is the macOS keychain, which keeps your data's key: choose “Always Allow”. If the keychain is locked, or if you refused, Twoody shows “Your data is locked”: unlock your session, then click “Try again”. Twoody changes and deletes nothing, and never makes an empty database in place of your data. Neither Twoody nor Osmove has a copy of that key: if your keychain is reset, or if the data folder is copied to another computer, your data no longer opens, unless you restore the keychain from a backup. The same goes on Windows with your user account, and on Linux with your key manager.
Twoody put an unencrypted copy of my data in the Trash.
That is on purpose. To encrypt your data, Twoody makes an encrypted copy, checks it page by page and row by row, puts it in place of the old database, then moves the old unencrypted database to the Trash (the Recycle Bin on Windows), without deleting it itself. It stays readable there until the Trash is emptied: Twoody tells you once, with its size (“An old unencrypted copy of your data is in the Trash.”). Once Twoody opens normally, empty the Trash to erase it. The backups Twoody keeps before its updates are encrypted the same way, in the background.
Languages
Which languages does Twoody speak, and how do I change it?
Ten, on the computer and on the iPhone: English, French, German, Spanish, Italian, Portuguese (Brazil), Dutch, Japanese, Chinese (Simplified) and Korean. On the computer: Settings › General › Language, where “Automatic (the system's language)” follows your system; on the iPhone: Settings › Appearance › Language. Whatever the screens' language, Twoody answers in the language you write in.
Updates
How do I update Twoody?
On Mac and Windows, Twoody looks for a new version every night around 3 a.m., and tells you when there is one: “Install” downloads it, and Twoody restarts on the new version. Settings › Updates › “Check now” looks at once. On Linux, updates are manual: install the new AppImage or .deb package over the old one; your data stays.
Uninstall
How do I uninstall Twoody and erase everything?
Quit Twoody and remove the app, then delete its data folder, which holds your conversations, your memories, the index of your documents and the models: ~/Library/Application Support/twoody-desktop on a Mac, %APPDATA%\twoody-desktop on Windows, ~/.config/twoody-desktop on Linux. Your documents themselves are not touched. Step by step: uninstall Twoody.
How do I delete my Twoody account?
In Twoody on your computer, Settings › Account › “Delete my account…”; in the iPhone app, “Delete the account”. Or write to support@twoody.com from the account's address. What the account keeps is erased; what is on your computer stays until you uninstall Twoody: what deleting erases.
Troubleshooting
The iPhone, or someone I share with, cannot reach my computer.
Your computer answers only while it is on and awake, with Twoody open: a computer asleep or shut down answers no one. On a Mac, Twoody stays in the menu bar when you close its window, and “Open Twoody with this session, in the status bar” opens it when you log in; keep the Mac from going to sleep if you use it from afar. On Windows and Linux, closing Twoody's last window quits it.
Twoody does not answer, or says the model is not loaded.
After Twoody opens, the first question loads the model into memory: Twoody shows its progress, and the answer follows. If the engine does not start, Twoody says so: “Try again”, or “Show the log” to see why (on Windows, it offers the missing Microsoft library). With MLX, Models › “Advanced” says when it did not start, and its log, mlx.log, says why. If memory is short, close heavy apps, or choose a smaller model in Models.
Windows says “Windows protected your PC”, or my antivirus holds the installer.
Windows SmartScreen can show it for a new app, until the app has built a reputation. Check that the installer is signed by Osmove (right-click › Properties › Digital Signatures), then click “More info”, then “Run anyway”. Some antivirus programs also scan the installer for a minute before letting it open, for the same reason (CyberCapture, at Avast and AVG): wait for the scan to finish.
The Linux AppImage does not open.
Make the file executable first: chmod +x followed by the file's name in a terminal, or the file's properties in your file manager (allow executing it as a program), then open it. If it still does not start, install the .deb package instead, on Debian, Ubuntu or a derivative.
Contact
How do I reach you?
In Twoody on your computer, Settings › About › “Write to us” (on a Mac, also in the Help menu); in the iPhone app, Settings › Help › “Write to us”. With a Twoody account, your message reaches us through the account, with the e-mail address to answer you at if you leave it; “Include technical details”, unticked from the start, adds the app's and the system's versions. Without an account, your mail app opens with the message for us: nothing leaves until you send it. Or write to support@twoody.com; the other addresses are on the contact page. Please do not send your clients' documents by e-mail.
Not found what you were looking for?
Write to us at support@twoody.com, with your system and your version of Twoody, or see the contact page.