Skip to content

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.

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

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.

  1. 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 landing screen with the Sign in with Bakulai button

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

  3. 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
    The Setting up Agent Hermes progress screen

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

  5. 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
    The owner desk dialog, Model tab

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

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

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