Install and sign in

Who this is for: an owner installing the app for the first time, on a Mac or a Windows PC.

🖐 Hands-on step

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.

Steps

1. Download the installer for your computer from releases.bakulai.com and open it. On macOS drag Bakulai Agent into Applications; on Windows run the installer.

2. 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 — agent/start/01-sign-in.png

3. 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.

4. 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 — agent/start/02-setup.png

5. 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.

6. Open Settings → AI model and connect a model provider (account sign-in or API key). Without a model, agents cannot answer.

   Settings, AI model card — agent/start/03-model.png

Note

Signing in once is enough: the app hands its login to the agents, so no agent ever asks you to log in again. If your Bakulai password changes or the login is revoked, the Home screen shows a Link to Bakulai button.

Ask your agent

✦ 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

• 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-agent on macOS); Settings → Account & app → Open data folder shows it. Deleting it means a fresh setup.

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/logout first, 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

Requirements · The first-office wizard · Choose a model and key