Build and install from source

The Agent V homepage has download buttons for each installer on the latest GitHub Release at https://github.com/vyotiqai/vyotiq-agent-v/releases/latest. There is no app store listing. You can also run a local pnpm dev session, or pack an installer from this repository with electron-builder (–publish never).

The packaged product name is Vyotiq. Agent V is the product/agent inside that app. Electron is the packager and runtime, not the product name.

Before you pack or launch

You need pnpm, a folder you can use as a workspace, and at least one model provider you can configure after launch. Cloud providers require their own API key. Local Ollama and a private or loopback Custom OpenAI-compatible endpoint can be used without a key.

Packaging does not write a cloud API key. New settings initially select local Ollama with qwen2.5. That selection is not proof that Ollama is installed or reachable. Provider setup happens in Settings → Providers.

From the repository root:

pnpm install

For day-to-day development without an installer, pnpm dev is enough. Continue with the first useful run.

Pack an installer

Scripts in package.json run pnpm build then electron-builder. Default output is dist-package/. If that directory is locked (EBUSY), use the :alt scripts, which write to dist-package-alt/.

Script	Target	Artifact name (1.0.0)
pnpm pack:win	Windows NSIS	Vyotiq-1.0.0-setup.exe
pnpm pack:mac	macOS DMG	Vyotiq-1.0.0-.dmg
pnpm pack:linux	Linux AppImage	Vyotiq-1.0.0.AppImage
pnpm pack:dir:win	Unpacked Windows dir	win-unpacked/ with Vyotiq.exe

Names come from electron-builder.yml:

• Windows NSIS: ${productName}-${version}-setup.${ext}
• macOS DMG: ${productName}-${version}-${arch}.${ext}
• Linux AppImage: ${productName}-${version}.${ext}

productName is Vyotiq. version is the root package.json version.

Install on Windows

1. Pack with pnpm pack:win (or pack:win:alt).
2. Run Vyotiq-1.0.0-setup.exe from the output directory.
3. Choose the installation directory when the installer asks.
4. Launch Vyotiq from the Start menu or desktop shortcut.

The installer is per-user (perMachine: false), creates Start menu and desktop shortcuts named Vyotiq, and can launch the app when setup finishes (runAfterFinish: true). Uninstalling does not delete the app-data directory (deleteAppDataOnUninstall: false).

Install on macOS

1. Pack with pnpm pack:mac.
2. Open Vyotiq-1.0.0-.dmg and install the application.
3. Launch Vyotiq.

The current package configuration leaves notarize: false for local packs. GitHub Releases notarize the macOS DMG only when Apple ID, app-specific password, and team ID secrets are present at pack time. Unsigned builds can require an explicit Gatekeeper confirmation before first launch.

Install on Linux

1. Pack with pnpm pack:linux.
2. Mark Vyotiq-1.0.0.AppImage executable using your desktop file manager or shell.
3. Run the AppImage.

The packaged application targets the system architecture used for the pack. There is no repository-level claim that every Linux distribution is supported.

Verify the installation

Open Settings → About. The page shows the Vyotiq version, Electron, Chromium, Node.js, platform, and architecture. Copy copies that build information for support.

Continue with the first useful run. If the app opens but a run cannot start, use Provider and model issues.