Catalogue site, real example output, README visuals - #1
Merged
Merged
Conversation
- docs/: GitHub Pages catalogue of all 26 headers (filter by group and dependency, recipe shortcuts, install-command builder), six offline examples with their captured MSVC output, one-file diagram - examples/offline: cache, cost, guard, format, json, compress; CI builds them with g++ against each library's current header and diffs output - tools/build_site.py regenerates the site; CI checks it is up to date - README: banner, one-file diagram, example image, link to the site
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Makes llm-cpp the front door for the whole family of 26 headers.
What changed
docs/: a catalogue of all 26 libraries. You can filter by group and by what each one needs (none or libcurl), or use the "I want to..." shortcuts. Each card shows the header's real line count and its implementation macro, plus a copy-curl button. Tick headers and the install section writes the fetch loop, one*_IMPLEMENTATIONfile per header, and the build line. It adds-lcurlonly when something you picked needs it. There are six tabs of real code next to real output, a diagram showing that copying one file is the whole install, and every header drawn to scale by line count. No external fonts, no trackers, light and dark.examples/offline/: complete programs for llm-cache, llm-cost, llm-guard, llm-format, llm-json and llm-compress, with their output committed. The output was captured with MSVC 19.44. CI now downloads each library's current header, builds every example with g++, and diffs the output against the committed files. The g++ output matched MSVC byte for byte on the first run.tools/build_site.pyrebuilds the site fromtools/libraries.json(the README tables plus line counts) and the examples. A second CI job fails ifdocs/index.htmldrifts..github/social-preview.png(1280x640), also served as the site's og:image.Checked today: all 26 implementations, each in its own .cpp, compile and link into one binary (MSVC 19.44 x64 + vcpkg libcurl).
Before / after (README)
Site