Heartmorrow

The first evening

Bring the lamps home.

Heartmorrow runs on your own machine. Download the project, run the installer for your platform, and open the local address it gives you. The self-contained path does not require Node.js or pnpm to be installed first.

Download the ZIP View on GitHub Installation FAQ →

Quick start

From download to Day 1.

Use the self-contained installer unless you specifically want to manage the Node environment yourself.

  1. Get the files

    Download the ZIP above and extract it somewhere you can find again. If you use Git, clone the project instead:

    git clone https://github.com/HMDSimDev/heartmorrow.git
cd heartmorrow

  2. Run your platform’s installer

    The installer downloads the matching official Node.js build and keeps its tools inside the Heartmorrow folder.

    Windows

    PowerShell

    powershell -ExecutionPolicy Bypass -File .\install.ps1

    macOS & Linux

    Terminal

    chmod +x install.sh run.sh
./install.sh

    Android

    Termux

    chmod +x install.sh run.sh
./install.sh

    Use the Linux installer inside Termux, then play in your phone’s browser.

  3. Launch Heartmorrow

    Windows

    .\run.bat

    macOS, Linux & Android

    ./run.sh

    Open http://localhost:5173 if the page does not open automatically. The installers are safe to run again when you need them.

  4. Connect a language model

    Open Settings → Model & diagnostics. Choose the adapter for your local server or hosted provider, enter its connection details, select a model, and press Test connection. A green result means you are ready to begin.

    Read the model setup guide

Already have the tools?

Use your own Node environment.

You need Node.js 20 or newer and pnpm. This path uses the versions already installed on your system.

pnpm install
pnpm seed
pnpm dev

Platform compatibility. Heartmorrow has been tested on Windows, macOS, Linux, and Android through Termux. It can run on any platform that provides a compatible Node.js environment.