Installation

Source checkout

The CLI/runtime supports Node.js >=20.17.0 <25. Use Node.js 22.12.x or newer for a full source checkout and Windows packaging; the repository pins 22.12.0 in .node-version. Git is required for project registration, worktrees and pull requests.

git clone https://github.com/Octomynd/octomynd-maestro.git
cd octomynd-maestro
npm install
Copy-Item .env.example .env.local
npm run smoke
npm run dev:platform

Configure only the integrations you need. Telegram is optional. Do not copy provider credentials from another machine and never commit .env.local.

Packaged Windows app

The Windows installer bundles Electron, the compiled backend and the terminal launcher. The target machine does not need Node/npm/tsx just to launch Maestro. Git and the provider CLIs or API credentials are still user-provided.

The supported public distribution is a versioned GitHub Release containing the installer and a SHA-256 checksum. An unsigned beta is free to distribute, but Windows SmartScreen can still show a first-download warning. Verify the checksum and download only from the project’s Releases page.

On a clean machine:

1. Install Git.
2. Run Maestro-Setup-<version>-x64.exe.
3. Open Maestro and configure Providers.
4. Register a Git project and prepare its own dependencies.
5. Create a task and watch it from the Dashboard.

User data is kept under %APPDATA%\Maestro, separate from the installation folder. The bundled maestro.cmd exposes the same terminal commands without an external Node installation.

Building a release

Builds are created from main on a build machine with Node 22.12.x or newer:

npm install
npm run release:win

The installer is written to release/. See the repository’s desktop release notes for native dependency and clean-machine validation details.