Skip to content

Commit f51fd3a

Browse files
committed
docs: add the hero image
One drawing at the top of the README. It reads left to right: a rack, a processor, the AQL queue as a ring, the KV cache as a tape of blocks, and a single token coming out the far end. That is the repository in one picture, so it earns the space. Downsampled 2:1 from the source, which for line art doubles as antialiasing, and written back with no ancillary chunks at all. Three chunks: header, pixels, end. No EXIF, no XMP, no colour profile, no embedded provenance manifest. The alpha channel was fully opaque so dropping it was lossless. 7.3 MB to 1.4 MB. docs/art/README.md records that the drawing was art-directed by us and rendered by an image model, and that nothing in it is load-bearing: every claim in this repository lives in prose, a command you can run, or a gate that fails when the claim is false.
1 parent eaba730 commit f51fd3a

3 files changed

Lines changed: 37 additions & 0 deletions

File tree

README.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# mainarch
22

3+
![A rack, a processor, the AQL queue drawn as a ring, the KV cache as a tape of
4+
blocks, and a single token coming out the far end, in isometric line
5+
work](docs/art/hero.png)
6+
37
Running a large language model on an AMD GPU normally means going through ROCm,
48
and ROCm is a lot of software. There's the HIP runtime, the HSA runtime beneath
59
it, the thunk library beneath that, and only then the kernel driver that actually
@@ -712,3 +716,7 @@ publicly.
712716
## License
713717

714718
Apache License 2.0. See [LICENSE](LICENSE).
719+
720+
The one image in this repository was art-directed by us and rendered by an image
721+
model. [docs/art/README.md](docs/art/README.md) says which one and why nothing in
722+
it is load-bearing.

docs/art/README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Art
2+
3+
`hero.png` is the one image in this repository. It reads left to right: a rack, a
4+
processor, the AQL queue as a ring, the KV cache as a tape of blocks, and a
5+
single token coming out the far end. That is what this stack does, so it seemed
6+
worth showing rather than describing.
7+
8+
## Provenance
9+
10+
The drawing was art-directed by us and rendered by an image model from a written
11+
prompt specifying the isometric line style, the paper ground, the single accent
12+
colour, and the objects in order. It is not hand-drawn and we would rather say so
13+
than have someone work it out.
14+
15+
Two things follow from how it was made, and both were deliberate. The image
16+
carries no words at all, because image models are unreliable at text and a
17+
diagram that misspells `wavefront` is worse than no diagram. And nothing in it is
18+
load-bearing: every claim in this repository is made in prose, in a command you
19+
can run, or in a gate that fails when the claim is false. The picture is there to
20+
orient you, not to argue.
21+
22+
## The file
23+
24+
1461x806, 8-bit RGB, 1.4 MB. It was downsampled 2:1 from a 2922x1612 source with
25+
a box filter, which for line art doubles as antialiasing. The alpha channel was
26+
fully opaque so dropping it was lossless.
27+
28+
It carries no ancillary chunks at all, so no EXIF, no XMP, no colour profile and
29+
no embedded provenance manifest. Three chunks: header, pixels, end.

docs/art/hero.png

1.38 MB
Loading

0 commit comments

Comments
 (0)