Install

Set up Gihanga for local project building.

Start with the repository-based CLI today. Desktop installers will be added when Windows, macOS, and Linux release packages are ready.

UpskillsAfrica Foundation logoGihanga setup
Recommended path todayInstall dependenciesRun the CLIBuild Linux desktop debug appFollow release packaging updates
01

Check Gihanga help

Start from the Gihanga command itself so every learner sees the same workflow.

gihanga ubufasha
gihanga genzura
02

Check local readiness

Use the built-in readiness check before creating or opening a project.

gihanga genzura
gihanga uko-bimeze
03

Run the CLI

Gihanga commands are Kinyarwanda-first, with English aliases available for teams that need them.

gihanga ubufasha
gihanga genzura
gihanga ingero
gihanga tangira ishuri-ai ai-ibanze
04

Create a project

Choose a starter and create a local folder through Gihanga.

gihanga ingero
gihanga tangira rubuga urubuga-nuxt
05

Open desktop guidance

The desktop companion uses the same Gihanga brand system and local-first workflow direction.

gihanga desktop
gihanga genzura
06

Run local agent workflow

Use Gihanga commands for local agent work and project task processing.

gihanga umukozi:rimwe
gihanga umukozi:kurikirana

Platform notes

Install direction by operating system.

Windows

Use Gihanga commands for CLI workflows today. Desktop installer packaging is planned before public download.

gihanga genzura

macOS

Use Terminal with Gihanga commands for CLI workflows. App bundle packaging and signing are planned.

gihanga ingero

Linux

Use Gihanga commands for CLI and desktop workflow guidance.

gihanga desktop

Troubleshooting

If setup fails, start with these checks.

CLI command is not recognized

Use the Gihanga command directly: gihanga ubufasha.

Flutter desktop build fails

Run gihanga genzura and follow the readiness notes for your operating system.

Desktop installers are missing

That is expected for now. Public Windows, macOS, and Linux packages are planned but not released yet.

Next

Read the docs for commands, templates, and workflow.

Open docs