---
app: agent
audience:
  - owner
since: 0.1.0
ui_only: true
agent_actions: []
agent_examples:
  - how do I install Bakulai Agent on another computer?
  - the setup is stuck, what now?
llm_weight: normal
title: Install and sign in
description: Download the app, sign in with your Bakulai account and let it set
  up the agent runtime.
editUrl: true
head: []
template: doc
sidebar:
  order: 3
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { Steps, Aside } from "@astrojs/starlight/components";
import { AgentAsk, UiOnly, Shot } from "@components";

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

<UiOnly />

## Steps

<Steps>

1. Download the installer for your computer from [releases.bakulai.com](https://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. <Shot src="agent/start/01-sign-in.png" alt="The landing screen with the Sign in with Bakulai button" />

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. <Shot src="agent/start/02-setup.png" alt="The Setting up Agent Hermes progress screen" />

5. When the office appears, the **first-office wizard** offers to hire a team for your kind of business — [take it](/agent/start/first-office-wizard/) or press **Skip — I'll build it myself**.

6. 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. <Shot src="agent/start/03-model.png" alt="The owner desk dialog, Model tab" />

</Steps>

<Aside type="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.
</Aside>

## Ask your agent

<AgentAsk />

## 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](/agent/start/requirements/) · [The first-office wizard](/agent/start/first-office-wizard/) · [Choose a model and key](/agent/models/choose-a-model-and-key/)