Install Haruno on your Mac

What your Mac needs, how to install Haruno and sign in, what the one-time secure-sandbox download is, and how Haruno stays up to date.

System requirements

Haruno runs on a Mac with Apple silicon and macOS 15 Sequoia or later. There is no version for Intel Macs.

RequirementWhat Haruno needs
MacApple silicon (an M-series chip, M1 or later).
macOSmacOS 15 Sequoia or later.
Free disk spaceAbout 5.5 GB the first time Haruno opens, and again when an update brings a new secure sandbox: the download (about 1 GB) and its unpacked copy (a little over 4 GB) are both on disk while it installs. Sizes can change between versions; if space is short, Haruno tells you how much it needs.
Internet connectionTo sign in, chat, update, download the sandbox and bring in QuickBooks months. Importing exports and closing a month do not need one.
A Haruno accountBought through our team. Up to five computers can be signed in to one account at a time.

To check your Mac, choose Apple menu ▸ About This Mac. To buy Haruno, see Pricing. If you use Windows, read Haruno on Windows below first.

Download and install

Download the disk image, drag Haruno into your Applications folder and open it. Haruno is signed by Inferara and notarized by Apple, so the only security prompt you should see asks you to confirm opening an app downloaded from the internet. You do not need to change any security setting.

  1. Download Haruno for Mac.

    Go to haruno.ai/download/macos (always the current release). Or, on your account dashboard (the website where you manage your account) at haruno.ai/dashboard, open Account and click Download for macOS on the Get the app card.

  2. Open the downloaded disk image.

    It is in Downloads: Haruno, the version number, then .dmg. Its window shows Haruno and your Applications folder.

  3. Drag Haruno onto the Applications folder in that window.

    Then eject the disk image in Finder, and delete the download if you like.

  4. Open Haruno from your Applications folder.

    The first time, macOS asks you to confirm. Click Open. Haruno opens on the Portfolio.

What you see the first time Haruno opens

There is no setup wizard and no folder to choose: Haruno creates and manages the folder that holds your books itself (see Where the books are stored).

What you seeWhat it means
The Portfolio, reading Build your portfolio, with Add company and Import existing books…Your portfolio is empty. Add company sets up your first company. Import existing books… is only for books kept by an earlier version of Haruno.
A request to allow notificationsHaruno uses them when a reply is ready, when the assistant waits for your approval and when a scheduled task runs. If you decline, you see these in the app only; turn them on later in System Settings ▸ Notifications ▸ Haruno.
Not signed in at the bottom of the sidebarSign in before your first chat.
At the foot of the sidebar, above the account row, a notice headed Secure sandboxThe one-time sandbox download has started. Only chat waits for it.
A blossom icon in the menu barHaruno's menu for scheduled tasks, shown while Run in the background (Settings ▸ General ▸ Automations, Advanced view only) is on, as it is by default.
Possibly, a one-time request to read files in your Documents folderHaruno reads the files there that you open, attach or import. Allow it if you keep exports there.
Later, on first use of voice input, a request for the microphoneHaruno records only while the microphone button is on. The recording goes to Haruno's transcription service to be turned into text, then is discarded.

To set up your first company, go on to Your first close. If you kept books in an earlier version of Haruno, see Import books from an earlier version.

Sign in

Signing in links this Mac to your Haruno account, in your browser: you approve this Mac on a web page and the app picks up the approval on its own. The app never asks for your password, and there is no code to type. You need to be signed in to chat with Haruno.

  1. Start sign-in from the sidebar or from Settings.

    Click the account row at the bottom of the sidebar (it reads Not signed in) and choose Sign In…. Or open Settings (⌘,), and in General under Account click Sign in to Haruno. Your browser opens.

  2. Sign in to your Haruno account in the browser, if it asks.

    Use Continue with Google; the page offers no other way to sign in. If it reads This account needs help connecting to Google. Contact support to restore access., write to info@inferara.com.

  3. Check the device name, then approve this Mac.

    The page asks Authorize this device? and says A desktop app is asking to use your Haruno account. Check that Device shows your Mac's computer name, then click Authorize.

  4. Go back to Haruno.

    The browser shows Signed in ✓, perhaps after Device authorized — return to the app. for a moment, and you can close the tab. Haruno finishes by itself: the account row shows your email with your plan beneath it.

While Haruno waits, the account row reads Signing in… and its menu offers Cancel Sign In. Approve within five minutes: after that Haruno stops waiting and shows “Sign-in didn't complete. Please try again.”, and a later Authorize in the browser never reaches the app. Start sign-in again from Haruno.

Only approve a request you started
If Authorize this device? appears when you did not just start a sign-in, or the device name is not your Mac's, click Deny: no computer is linked. Deny does not tell the app, so cancel any sign-in waiting on your Mac with Cancel Sign In.

Signing in on more than one computer

One account can be signed in on up to five computers at a time, Mac or Windows, all drawing on the account's one AI allowance (see Usage allowance). At the limit, the approval page shows “Device limit reached — revoke a device on the Account page first.” To free a place:

  1. On the account dashboard (haruno.ai/dashboard), click Account.
  2. Under Devices, click Revoke next to a computer you no longer use.
  3. On the new computer, cancel any waiting sign-in (Cancel Sign In), then start again.

Signing out also removes a computer from the list, if it is online at that moment. Signing the same Mac in again reuses its own place.

What signing in does not do

  • It does not sync anything between computers. Your books, settings and connector sign-ins stay on the Mac where you set them up, so two people cannot work on one portfolio from two Macs. Share results as exported reports or PDFs.
  • It does not put your password on the Mac. Haruno keeps only its own sign-in, in your macOS Keychain.
  • It does not need repeating. After 90 days unused, the sign-in lapses and you sign in again the same way.
Sign-in messages and what to do
MessageWhat to do
You're not signed in. Sign in to Haruno in Settings (⌘,) to start.You sent a chat message while signed out. Sign in, then send it again.
Couldn’t sign in, with Try Again and CancelSign-in from the account menu failed; the reason, one of the messages below, is under the title. Click Try Again, or act on the reason.
Could not start sign-in. Check your connection and try again.Haruno could not reach its service. Check your internet connection and try again.
Could not open your browser to finish signing in.Check that you have a default browser set, then try again.
Could not complete sign-in. Please try again.The last step failed after you approved. Start again. If it keeps failing, check Account ▸ Devices on the account dashboard: five computers may already be signed in.
Sign-in was not approved: … or Sign-in was cancelled before it was approved.The browser came back without an approval. Start again and click Authorize.
Sign-in could not be verified. Please try again.A security check on the approval failed. Start again.
Could not save this device identity. Please try again.Haruno could not save its sign-in in your Keychain. Try again.
Sign-in isn't available right now. Please try again.Try again later.
On the account dashboard: Could not revoke the device. Please try again.Try again.
Sign in to use voice input. Open Settings (⌘,).Voice input works only while you are signed in. Sign in, then dictate again.

Messages in the browser, a rejected sign-in and more are in Signing in; usage and billing messages in Usage, plan and billing.

The one-time secure-sandbox download

Right after its first launch, Haruno downloads its secure sandbox: a sealed-off space on your Mac where the assistant works whenever you chat. It is a one-time download of about 1 GB that unpacks to a little over 4 GB. It runs in the background and uses none of your AI allowance. Until it is ready you can type in the chat but not send. Everything else works in the meantime: the Portfolio, adding companies, importing exports, drafting a mapping and closing a month do not use the sandbox, though the questions for management Haruno drafts after a close do.

What it is for

The sandbox is an isolated virtual machine that holds the assistant while it reads what it needs to answer. It can open the folder your chat works in, your books (every company's, not only the one on screen; read-only, except a company's mapping file), the files you attach to a chat and, with Use memory on, your saved memory and past chats. It cannot see the rest of your Mac, and the app checks every connection it makes. In the normal view, where a new install starts, the sandbox is always on. The close never uses it: it runs in the app, on your Mac, and sends nothing. Details: What the sandbox can see, Which websites it can reach and Where your data goes.

While it downloads

Follow it in the sidebar, on every page. The notice headed Secure sandbox, above the account row, shows each stage, checking, downloading with a progress bar, verifying and unpacking, and disappears when you can send. If the sidebar is hidden, a notice shows above the chat box in Chat (⌘2) instead. Until then the send button is off; its tooltip begins “Please wait — the secure sandbox is still being prepared.” Offline, the download waits and starts on its own when you reconnect.

The download picks up where it stopped, after a dropped connection and after you quit and reopen Haruno; you do not need to keep Chat open. The sandbox downloads again after an update that brings a new one (the old one is removed once the new one is in place), and after Delete local data… in Settings erases it; chat waits each time.

If the download stops or fails

When the download cannot finish, the notice says why and, where trying again can help, shows a Retry button.

MessageWhat to do
The secure sandbox needs X of free space and this Mac has Y. Free some space and it will retry.Free the space it names (see System Settings ▸ General ▸ Storage), then click Retry or switch back to Haruno.
The secure sandbox image for this version isn’t available yet. Haruno will keep checking.Nothing. The download starts once it is available.
This build can’t install its secure sandbox. Install the latest Haruno app.Update Haruno (Haruno ▸ Check for Updates…).
The secure sandbox couldn’t be written to disk: … or The secure sandbox couldn’t be prepared: …Haruno tries again by itself after a pause; click Retry to try now. If it keeps failing, contact us with the full message.

After a failure, the send button's tooltip reads “The secure sandbox could not be prepared, so a message cannot be sent yet. …” For other messages Haruno tries again by itself; click Retry to try now, and if it keeps failing, see The secure-sandbox download. A message that says “Retry in Settings ▸ Advanced ▸ Security.” names a tab only the Advanced view has: in the normal view, use Retry on the sandbox notice in the sidebar.

If the sandbox won't start

Once installed, the sandbox starts for each conversation. If it cannot, the chat shows “The sandboxed engine couldn't start: … The session was blocked instead of running without isolation. Retry; if it keeps failing, the sandbox may be unavailable on this Mac.” Send your message again. If it keeps happening, contact us with the full message; see Troubleshooting.

Updates

Haruno checks for a new version when it opens and every hour after that, and tells you when one is ready. To check now, choose Haruno ▸ Check for Updates… in the menu bar; it works even when the main window is closed. An update replaces the app; your books, settings and sign-in stay as they are.

Two switches in Settings (⌘,) ▸ General ▸ Software Update control the automatic part: Check for updates automatically (on by default) and Download and install updates automatically (off; installs a downloaded update when you quit, instead of asking). See Settings.

To see which version you have, choose Haruno ▸ About Haruno, or click the version line in the account menu to copy it for support. The first time you open a new version, Haruno can show a What's New window with that version's page from haruno.ai; Help ▸ What's New in Haruno opens it at any time.

If your Haruno has no Portfolio

If the sidebar of the Haruno on your Mac has no Portfolio row, it is an earlier version this guide does not describe. Update it with Haruno ▸ Check for Updates…, or download the current release from haruno.ai/download/macos and drag it into Applications to replace the old copy. The new version leaves the review workspace folder you worked in before as it was, and does not pick it up: to bring those companies in, use Import existing books…; see Import books from an earlier version.

Sign out, switch accounts or remove Haruno

Sign out is in Settings, not in the account menu: press ⌘, and, in General under Account, click Sign out. The account row then reads Not signed in. Signing out ends this Mac's sign-in and, when the Mac is online, frees its place in your account's device list; if it was offline, revoke it under Account ▸ Devices on the account dashboard. Your books, chats and settings stay on the Mac.

Switch to another account

The approval page links this Mac to whichever account your browser is signed in to, so switch the browser too.

  1. Sign out in Settings ▸ General ▸ Account.
  2. In your browser, sign out of the account dashboard if it is signed in to the old account.

    Use Sign out at the bottom of the dashboard's sidebar. This signs out the browser only; it does not sign out your computers.

  3. In Haruno, start sign-in again, sign in to the other account in the browser and click Authorize.

Your books are not tied to an account: after you switch, the Portfolio shows the same companies. The account you sign in with decides the plan shown and whose AI allowance your chats draw on.

Sign out a computer you can't reach

On the account dashboard, open Account and click Revoke next to the computer under Devices. It is signed out the next time it contacts Haruno. Revoking ends only its sign-in; whatever is stored on that computer stays there.

Remove Haruno from your Mac

Moving Haruno from Applications to the Trash removes the app only. Your books, chats, settings and the secure sandbox stay on the Mac, and the Mac stays signed in to your account. So first sign out in Settings to keep your books on the Mac, or use Delete local data… to erase them as well. Then quit Haruno and move it to the Trash. What Delete local data… removes and leaves is in Delete local data.

Sign out is not Delete local data…
Delete local data…, at the foot of Settings ▸ General, signs you out and also permanently erases your books, connector sign-ins, chats, memory and settings on this Mac, then reopens Haruno as new. It does not delete your Haruno account or disconnect a connector at the provider.

Haruno on Windows

Haruno for Windows runs the month-end close too: it has the portfolio, mapping, close, reconciliation, reports and lock, as well as a chat assistant for files in a folder you choose, with history, scheduled tasks and connectors.

The Windows app installs from haruno.ai/download/windows (the file is Haruno-Setup.exe) and uses the same account and browser sign-in; each Windows computer counts toward the five-computer limit. Setup, updates and the differences from the Mac: Haruno on Windows.

Next steps

Haruno is installed and signed in. Set up your first company and close its month.