Getting Started Building from Source

Building from Source

HWControl 2.0 uses three main components.

Native engine

The root CMake project requires CMake 3.16+ and C++17. The build fetches a pinned llama.cpp revision through CMake FetchContent.

Typical native build:

cmake -S . -B build -DGGML_NATIVE=OFF -DGGML_CCACHE=OFF
cmake --build build
ctest --test-dir build --output-on-failure

Go bridge

The bridge is in bridge_service and targets Go 1.22.

cd bridge_service
go test -count=1 ./...
go build -buildvcs=false -trimpath -ldflags='-s -w' -o ../bridge-service ./src

Flutter dashboard

The dashboard is in gui_dashboard.

cd gui_dashboard
flutter pub get
flutter analyze
flutter test --no-pub

Platform-specific release jobs create the required Flutter platform runner files during CI.

Model

The native project expects the Gemma GGUF model path under ai_core/models/ unless an alternate runtime path is configured. The model is treated as a runtime input rather than being downloaded during CMake configure.