Install and first run
Download
Sign up at honawa.com with your email. Your dashboard there has your invite code and the download for your computer.
If we sent you a code ourselves, use the link we sent. It ends with your invite code, for example:
- Mac with Apple chip (M1 or later):
…/downloads/0.1.0/Honawa_0.1.0_aarch64.dmg?code=HNW-XXXX-XXXX - Mac with Intel chip:
…/downloads/0.1.0/Honawa_0.1.0_x64.dmg?code=HNW-XXXX-XXXX - Windows:
…/downloads/0.1.0/Honawa_0.1.0_x64-setup.exe?code=HNW-XXXX-XXXX
Not sure which Mac you have? Apple menu → About This Mac: "Chip: Apple M…" means Apple chip.
Install on a Mac
- Open the
.dmgfile we sent you 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. Enter your invite code (
HNW-XXXX-XXXX), or 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.
Invite code or your own key?
| Invite code | Your own key | |
|---|---|---|
| Cost to you | Included with the code | 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 |
With an invite 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.