Biergarten Pipeline is a C++23 command-line tool that reads a local city list, looks up a short Wikipedia summary for each sampled city, and generates brewery names and descriptions. The current code samples up to four locations per run, then uses either a local GGUF model or the mock generator to produce the output.

Pipeline

Stage	What happens
Load	Reads `locations.json` and picks up to four city/country pairs.
Enrich	Fetches a short Wikipedia summary for each city in parallel with `std::async`.
Generate	Passes the city, country, and summary to the active generator.
Log	Writes the generated breweries and any warnings through `spdlog`.

If one Wikipedia lookup fails, the pipeline skips that city and keeps going.

Core Components

Component	Role
BiergartenDataGenerator	Orchestrates loading, enrichment, generation, and logging.
WikipediaService	Fetches city summaries from Wikipedia.
LlamaGenerator	Runs local GGUF inference and validates output.
MockGenerator	Produces deterministic fallback data without a model.
JsonLoader	Parses the local `locations.json` file.
CURLWebClient	Handles HTTP requests to Wikipedia.

Build

Requirement	Notes
C++23 compiler	GCC 13+ or Clang 16+ are good starting points.
CMake	Version 3.24 or newer.
libcurl	Required for Wikipedia requests.
Optional GPU tooling	CUDA on NVIDIA, HIP/ROCm on supported AMD systems, Metal on Apple Silicon.

Boost, spdlog, and llama.cpp are fetched by CMake. On Apple Silicon, Metal is enabled automatically. On Linux, the build looks for CUDA or HIP/ROCm when the matching toolkit is present. Windows is not supported.

cmake -S . -B build
cmake --build build

If the dependency build fails on macOS, check the repo build notes.

Run

Run the executable from the build directory so the copied locations.json is available.

./biergarten-pipeline --mocked
./biergarten-pipeline --model /path/to/model.gguf --temperature 0.8 --top-p 0.92 --n-ctx 8192 --seed -1

Flag	Purpose
`--mocked`	Uses the mock generator instead of a model.
`--model, -m`	Path to a GGUF model file.
`--temperature`	Sampling temperature. Default: `0.8`.
`--top-p`	Nucleus sampling parameter. Default: `0.92`.
`--n-ctx`	Context window size. Default: `8192`.
`--seed`	Random seed. Default: `-1`.
`--help, -h`	Prints usage.

--mocked and --model are mutually exclusive. If neither is set, the program exits with an error. The sampling flags only matter when a model is loaded.

Layout

Path	Use
`includes/`	Public headers.
`src/`	Implementation files.
`locations.json`	Input city list copied into the build tree.
`prompts/`	Prompt text used by the model path.