Installation Guide (Legacy)

This page contains installation details. Operational usage should follow the playbooks.

Document Control

Field	Value
Author	Geraldson Muluh
Owner	GCBM Assistant maintainers
Last reviewed	2026-03-27
Review cadence	Monthly

Prerequisites

• Python >=3.10
• uv (recommended) or pip
• Windows installer users do not need local Python setup

Source Installation

bash git clone https://github.com/moja-global/gcbm_assistant.git cd gcbm_assistant uv pip install -e . gcbm-assistant

Alternative launch:

bash python -m gcbm_assistant.app

Windows Installer

1. Download the latest GCBM_Assistant_Setup_*.exe.
2. Run the installer.
3. Launch from desktop shortcut.

Building the Installer (Developer/Distributor)

Installer scripts are in installer/.

1. Stage files from manifest:

powershell .\installer\stage_files_from_manifest.ps1

1. Compile installer with Inno Setup script:

2. installer/gcbm_assistant_installer.iss

3. Retrieve generated installer from:

4. installer/output/

Related References

• Release and version policy
• Installer implementation notes are maintained in installer/README.md in the repository root.