Install and sign in
Who this is for: an owner installing the app for the first time — on a Mac, a Windows PC or a Linux machine.
Check Requirements first: the app needs a Pro or Max plan, an AI account or API key, and about 5 GB of free disk.
This part is done by you at the desktop app: QR codes, keys, tokens and deletions never pass through an agent or the tablet. An agent can only open the screen for you.
Download and open
Section titled “Download and open”Installers for every platform are at releases.bakulai.com/erp-agent-desk, newest version at the top.
Take the .dmg for your Mac — aarch64 for Apple Silicon (M1 and newer), x64 for Intel — and drag Bakulai Agent into Applications.
The app is not distributed through the App Store, so the first launch needs one confirmation: right-click the app → Open → Open. If macOS says the app is damaged, that is the same block with a harsher message — Install problems has the two-line fix.
Take the …_x64-setup.exe and run it. Windows SmartScreen shows “Windows protected your PC” because the installer carries no certificate yet: click More info → Run anyway.
No administrator rights are needed — the app installs for your user only.
Take the .AppImage for your architecture (amd64 or aarch64), make it executable and run it:
chmod +x "Bakulai Agent_<version>_amd64.AppImage"./"Bakulai Agent_<version>_amd64.AppImage"You need WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+, Fedora 38+) and FUSE 2 (libfuse2t64 on Ubuntu 24.04, libfuse2 before that). A .deb is published in the same version folder if you prefer to install it with apt.
Sign in and let it set itself up
Section titled “Sign in and let it set itself up”-
Open the app. Press Sign in with Bakulai. Your browser opens the Bakulai login; sign in with the same account you use at erp.bakulai.com and press Allow. The browser tab can be closed afterwards.

The landing screen with the Sign in with Bakulai button -
The app checks your plan. Free and Kasir accounts see This feature is included in the Pro and Max plans with a View plans in Bakulai button.
-
Setting up Agent Hermes runs once: it downloads the agent runtime (about 1.7 GB, three to four minutes on a good connection) and prepares your own desk. Leave the window open.

The Setting up Agent Hermes progress screen -
When the office appears, the first-office wizard offers to hire a team for your kind of business — take it or press Skip — I’ll build it myself.
-
Click your own desk (Bakulai, in the Owner’s Office) → Settings in the panel header → the Model tab, and connect a model provider (account sign-in or API key). Without a model, agents cannot answer.

The owner desk dialog, Model tab
Ask your agent
Section titled “Ask your agent”Things you can say to an agent in Bakulai Agent:
“how do I install Bakulai Agent on another computer?”“the setup is stuck, what now?”No tool for this page yet — an agent can explain the steps and open the screen for you.
Limits & safety
Section titled “Limits & safety”- One Bakulai account per installation. The agents act as you in Bakulai (drafts carry your name).
- The runtime lives in the app’s data folder (
~/.bakulai-agenton macOS); Settings → Account & app → Open data folder shows it. Deleting it means a fresh setup.
Troubleshooting
Section titled “Troubleshooting”- Setup stops at “Node” — the bundled Node.js could not run; restart the app, it retries from where it stopped.
- “The agent runtime is not running” in the panel — Settings → Account & app → Run agent health check shows what is missing; Check for updates installs the latest app.
- The browser signed in as the wrong account — sign out at
erp.bakulai.com/app/logoutfirst, then press Sign in with Bakulai again. - Windows: the Chat tab says the terminal needs WSL2 — install WSL2 (Microsoft Store → Ubuntu) and restart the app; automations and channels work without it.
Related
Section titled “Related”Requirements · Install problems · The first-office wizard · Choose a model and key
