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:
- Mac with Apple chip (M1 or later): the
aarch64.dmgfile. - Mac with Intel chip: the
x64.dmgfile. - Windows: the
x64-setup.exefile.
Not sure which Mac you have? Apple menu → About This Mac: "Chip: Apple M…" means Apple chip.
Install on a Mac
- Open the
.dmgfile you downloaded and drag Honawa into Applications. - Open Honawa. macOS will say it can't check the app for malicious software, because alpha builds aren't registered with Apple yet.
- 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.
- 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.
- Edge asks again ("Publisher: Unknown") and the big button says Delete. Click the small ▾ arrow next to it and choose Keep anyway.
- 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:
- 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.
- 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. - Folder (optional). Pick a folder of documents Honawa may read. You can also let it create and edit text files there.
- 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:
- "Which posts are still drafts?"
- "Turn the article in my folder into a draft post."
- "Find posts with no excerpt and suggest one for each."
Cards marked Read only never change anything. Cards marked Asks first will show you each change before it happens.