Welcome! Your download is a zip file. This guide shows you how to open it, get past your computer's security warnings, run the installer, open Lifebot for the first time, and try it once so you see what it does. You don't need any technical background.
The whole install takes 10 to 20 minutes. Most of that is waiting for downloads, and none of it is difficult.
Mac with Apple silicon (M1 or later), Windows 10 or 11, or 64-bit Linux (Ubuntu, Debian or Fedora).
You'll download Hermes, the free AI engine Lifebot runs on, then Lifebot.
The Mac and Linux installers may ask for it once. Nothing shows as you type; that's normal.
The setup wizard asks after install: a ChatGPT subscription, Nous Portal, or an API key. A local model works too.
On a Mac you install Hermes first, then Lifebot. Hermes is the free, open-source AI engine that Lifebot runs on. The Lifebot installer doesn't install Hermes for you. Lifebot opens its installer in Terminal: double-click Install Lifebot to start, as shown in step 3. Pressing Return accepts the suggested answer, which is right for most people.
Download Hermes Desktop from hermes-agent.nousresearch.com/desktop. It's free. Open it and let it finish setting up. If Hermes offers to set up a model, you can do it now or skip it; Lifebot asks you again in its own setup.
Find lifebot-kit-macos.zip in your Downloads folder and double-click it. A folder named lifebot-kit appears next to it. Open that folder.
Double-click Install Lifebot. Your Mac asks whether to open it. Click Open. A Terminal window opens and the installer starts, as in the demo.
If it asks whether "Install Lifebot.app" wants access to control "Terminal.app", click OK. That's how the installer opens Terminal for you.

The installer starts with π Lifebot Kit. Press Return to accept each suggestion, and type y whenever it asks a yes or no question. That's it. The full list of questions is in What the installer asks.


bash support/install.sh.At Open Lifebot now? (Y/n), press Return. Lifebot opens with its setup wizard, and Terminal prints Lifebot is installed. You can close the Terminal window.

Prefer not to use Terminal at all? A coding agent app can run the installer for you. See Let a coding agent install it for you.
On Windows you install Hermes first, then Lifebot. Hermes is the free, open-source AI engine that Lifebot runs on. The Lifebot installer doesn't install Hermes for you.
Download Hermes Desktop from hermes-agent.nousresearch.com/desktop. It's free. Open it and let it finish setting up. If Hermes offers to set up a model, you can do it now or skip it; Lifebot asks you again in its own setup.
Right-click lifebot-kit-windows.zip β Properties. If you see This file came from another computerβ¦ at the bottom, tick Unblock and click OK. This one tick prevents most of Windows' warnings in the next step.
Then right-click the zip again β Extract All β Extract. Open the new lifebot-kit folder.
Double-click Install Lifebot.cmd. Or open a terminal window (Start β Terminal), drag the file into it, and press Enter.
The installer asks for a profile name and for your first name. Press Enter to accept each suggestion, and type y whenever it asks a yes or no question. It then installs Lifebot, Pixel Pomodoro and Typewriter under %LOCALAPPDATA%\Programs\Lifebot, adds them to the Start menu, and opens Lifebot.
Lifebot opens on Let's set up your Lifebot. The setup wizard walks you through the rest. Later, open Lifebot, Pixel Pomodoro or Typewriter from Start β Lifebot.

Prefer not to run the installer yourself? A coding agent app can do it for you. See Let a coding agent install it for you.
Works on 64-bit Ubuntu, Debian and Fedora. Install Hermes first, then Lifebot. The Lifebot installer doesn't install Hermes for you. On other distributions, also install Python 3 and the libraries the apps need, if they're missing.
Download Hermes Desktop from hermes-agent.nousresearch.com/desktop. It's free. Open it and let it finish setting up.
Right-click lifebot-kit-linux.zip and choose Extract Here. Or, in a terminal in the same folder:
unzip lifebot-kit-linux.zipOpen the lifebot-kit folder, right-click an empty spot, and choose Open in Terminal.
Starting it with bash works even if unzipping didn't keep the file's permission to run.
Press Enter to accept each suggestion, and type y whenever it asks a yes or no question. If you're asked for a password, type your computer password (it stays invisible) and press Enter. Lifebot opens at the end on Let's set up your Lifebot. The setup wizard walks you through the rest.

Prefer not to use the terminal? A coding agent app can run the installer for you. See Let a coding agent install it for you.
Pressing Enter (or Return) accepts the answer in brackets. Here's every question you might see on a Mac or Linux, in order, and what to do. Windows asks only the two questions listed in its steps above, plus Open the Hermes guide in your browser now? [Y/n] if Hermes isn't installed yet.
| You'll see | What to do |
|---|---|
| Open the Hermes website now? (Y/n) | Only shown if Hermes isn't installed. Press Enter to open the Hermes site, install Hermes, then run the installer again. |
| Prepare these and continue? (Y/n) | Linux only. Press Enter. It installs only the missing libraries the apps need, and asks for your password. |
| Choose where to set up Lifebot: | Only shown if you already use Hermes. Keep Create a new Lifebot profile (recommended) selected and press Enter. It keeps your existing Hermes setup separate. |
| New profile name [life] | Press Enter. |
| Continue with this profile? (y/N) | Only if you chose an existing profile. Type y only if Lifebot was installed there before. |
| Keep this profile and add only missing Lifebot files? (Y/n) | Shown when you reinstall onto a Lifebot profile. Press Enter. Your settings, persona, memories and jobs are kept, and a backup is made first. |
| What should Lifebot call you? | Type your first name and press Enter. |
| β¦ is already installed on this machine. Overwrite it? (y/N) | Press Enter to keep the app you have, or type y to replace it with the newer one from this kit. |
| Switch your default Hermes profile to 'life'? (Y/n) | Press Enter, unless you use Hermes for other things and want it to stay on your old profile. |
| Open Lifebot now? (Y/n) | Press Enter. Lifebot opens and its setup wizard walks you through the rest. |
~/.hermes/profiles/life (Windows: %LOCALAPPDATA%\hermes\profiles\life).The installer opens Lifebot for you the first time. After that:
| Computer | How to open Lifebot, Pixel Pomodoro or Typewriter |
|---|---|
| Mac | Press β Command + Space, type Lifebot, press Return. Or open it from the Applications folder. Tip: right-click its Dock icon β Options β Keep in Dock. |
| Windows | Start menu β Lifebot folder β Lifebot, Pixel Pomodoro or Typewriter. |
| Linux | Your applications menu, or ~/Applications/Lifebot.AppImage. |
| From Lifebot | The Apps tab has an Open App button under Pixel Pomodoro and another under Typewriter. |
The top card on Overview should say Lifebot is connected. If it says Couldn't connect just now, click Start gateway. If that doesn't help, see When something isn't working.

Do this once, right after the setup wizard, while Overview says Lifebot is connected. You'll make a tiny bit of real data with the two companion apps, then ask Lifebot about it. Ten minutes, and you'll know exactly what Lifebot is for.
In Lifebot, open the Apps tab and click Open App under Typewriter. Type three small things you'll really do today. Press Shift + Enter after the first two, and Enter after the last to print the list.
Do one of them now, then click it to tick it off.
Back in the Apps tab, click Open App under Pixel Pomodoro. For this test, set the minutes to 1, type a task like read the Lifebot guide, and press Enter. When it beeps, press Enter, type a short note, and press Enter again to LOG.
Then start a second session and give up on it on purpose: press Ctrl + C after a few seconds (the Control key, even on a Mac). The title says ABANDONED. Add a note like testing and press Enter. Lifebot treats abandoned sessions as useful information, not failures.
Lifebot talks to you the way ChatGPT does, but about your own day. If you connected Telegram or Discord in the wizard, message your bot. If not, click Launch Hermes Desktop on Overview and open a chat on your Lifebot profile. Ask:
A good answer names the Typewriter item you ticked, the one-minute session and its note, and the abandoned one with how long it ran. It also says which sources it read. Then try:
If the answer is wrong or Lifebot says it has no data, see When something isn't working. For how to use the apps on a normal day, and how to make Lifebot yours, continue to Use Lifebot.
If you'd rather not run the installer yourself, a coding agent desktop app such as Claude Code can do it for you: it reads the kit, runs the installer, and answers its questions. This works on Mac, Windows and Linux. It's completely optional, and it does exactly the same thing as the steps above.
Download Hermes Desktop for Mac, Windows or Linux and let it finish setting up. The Lifebot installer doesn't install Hermes for you, and neither will the agent unless you ask it to.
Download and open a coding agent desktop app, for example Claude Code. Sign in if it asks you to.
Unzip lifebot-kit-macos.zip, lifebot-kit-windows.zip or lifebot-kit-linux.zip as described in step 2 of your computer's section, so you have a lifebot-kit folder. Keep the folder together, including support.
In the coding agent app, create a new session. When it asks which folder to work in, choose the unzipped lifebot-kit folder. This gives the agent access to the installer and the support folder, and nothing else.
In the chat, type:
Install Lifebot for me.The agent runs the installer and comes back to you whenever it needs a decision, such as your first name or your computer password. When it says Lifebot is installed., Lifebot opens on Let's set up your Lifebot. The setup wizard walks you through the rest.