Skip to content

Run locally with Dev

Local Dev mode is usually used for quick development/debugging. In Dev mode, steps execution can be independent of Runner / sandbox isolation.

  • Node.js 20+
  • pnpm
  • Git
  1. Clone the source repo

    Terminal window
    git clone https://github.com/obiscr/maia.git
    cd maia
  2. Install dependencies

    Terminal window
    corepack enable
    pnpm install
  3. Start development service

    Terminal window
    pnpm dev

Then open:

In local mode, data will be stored in the following location by default.

  • macOS: /Users/alice/Library/Application Support/maia-data
  • Linux: /home/alice/.local/share/maia-data
  • Windows: C:\Users\alice\AppData\Local\maia-data

When maia repository has updates, run the following commands in the source code directory:

Terminal window
git pull
pnpm install
pnpm dev

If you have local uncommitted changes, resolve conflicts/commit them first before updating.