Install and first run

How to download Honawa, get past the one-time Mac or Windows warning, and set it up on first run.

Download

Sign up at honawa.com/start with your email. Your dashboard at honawa.com/dashboard has your Honawa code (HNW-XXXX-XXXX) and the download for your computer:

Not sure which Mac you have? Apple menu → About This Mac: "Chip: Apple M…" means Apple chip.

Install on a Mac

  1. Open the .dmg file you downloaded and drag Honawa into Applications.
  2. Open Honawa. macOS will say it can't check the app for malicious software, because alpha builds aren't registered with Apple yet.
  3. Open System Settings → Privacy & Security, scroll down, and click Open Anyway next to the Honawa message. Confirm once more.

If you're comfortable with Terminal, this does the same:

xattr -dr com.apple.quarantine /Applications/Honawa.app

After each update, macOS may ask whether Honawa can use your keychain (where it keeps your passwords). Click Always Allow.

Install on Windows

Alpha builds aren't signed by Microsoft yet, so Windows warns three times. Each is expected.

  1. In Microsoft Edge's downloads list: "…isn't commonly downloaded. Make sure you trust … before you open it." Point at the file, click … (More actions), then Keep.
  2. Edge asks again ("Publisher: Unknown") and the big button says Delete. Click the small ▾ arrow next to it and choose Keep anyway.
  3. Run the -setup.exe. If Windows shows "Windows protected your PC", click More info, then Run anyway.

Honawa installs for your user only (no administrator password) and adds a desktop shortcut.

First run

Honawa walks you through four steps:

  1. Connect your site. Enter the site address, your WordPress username and an application password. See Connect your WordPress site. You can skip this if you only want to work with files.
  2. AI. Choose I have an invite code and paste your Honawa code (HNW-XXXX-XXXX) from the dashboard, or enter your own provider's address, model and API key.
  3. Folder (optional). Pick a folder of documents Honawa may read. You can also let it create and edit text files there.
  4. Ready. Open the assistant and ask for something.

You can change all of this later under Connections.

Honawa code or your own key?

Honawa code Your own key
Cost to you Free trial, or a plan (see Plans and billing) You pay your AI provider
Setup Paste the code Provider address, model name, key
Models Honawa Lite, Pro or Max Any model your provider offers that supports tools
Limit The code's credit; the sidebar shows what's left Your provider's limits

Settings for OpenRouter, Cloudflare Workers AI and your own gateway, and the models that pass our tests, are on Use your own AI key.

With a Honawa code, pick Lite, Pro or Max in the box where you type. Lite is quickest and uses the least credit; Max is for long, multi-step jobs.

Your first task

Click one of the suggestion cards, or type a request such as:

Cards marked Read only never change anything. Cards marked Asks first will show you each change before it happens.