Packages

llm_db

2026.7.2
2026.7.3 2026.7.2 2026.7.1 2026.7.0 2026.6.4 2026.6.3 2026.6.2 2026.6.1 2026.6.0 2026.5.2 2026.5.1 2026.5.0 2026.4.8 2026.4.7 2026.4.6 2026.4.5 2026.4.4 2026.4.3 2026.4.2 2026.4.1 2026.4.0 2026.3.3 2026.3.2 2026.3.1 2026.3.0 2026.2.9 2026.2.8 2026.2.7 2026.2.6 2026.2.5 2026.2.4 2026.2.3 2026.2.2 2026.2.1 2026.2.0 2026.1.5 2026.1.4 2026.1.3 2026.1.2 2026.1.1 2026.1.0 2025.12.4 2025.12.3 2025.12.2 2025.12.1 2025.11.18-preview 2025.11.14-preview 2025.11.7-preview

LLM model metadata catalog with fast, capability-aware lookups.

HexDocs

Current section

Files

Jump to
Readme
48 Versions
6 Dependencies
Dependants
Files
Activity
llm_db guides package-footprint.md
Raw

guides/package-footprint.md 

# Package Footprint



The packaged catalog uses deterministic compact schema-v1 JSON. This changes

only JSON whitespace: decoded keys, values, array order, schema version, and

snapshot ID remain unchanged.



## Size comparison



Measured from the same 2026-07 packaged snapshot and package source tree with:



```shell

wc -c priv/llm_db/snapshot.json

gzip -n -c priv/llm_db/snapshot.json | wc -c

mix hex.build

```



| Artifact | Pretty JSON | Compact package | Change |

| --- | ---: | ---: | ---: |

| Raw `snapshot.json` | 12,198,384 bytes | 6,325,229 bytes | -48.1% |

| Gzip (`gzip -n`) | 582,088 bytes | 455,025 bytes | -21.8% |

| Hex archive | 756,224 bytes | 623,616 bytes | -17.5% |



These measurements are release-audit evidence, not fixed size budgets; catalog

growth will change them.



## Opt-in sparse v2 comparison



The same 168-provider, 5,988-model catalog was encoded with the schema-v2 sparse

rules using `LLMDB.Snapshot.to_sparse/1`. The packaged and published default is

still v1; this comparison records the evidence for the opt-in format.



| Artifact | Compact v1 | Sparse v2 | Change from v1 |

| --- | ---: | ---: | ---: |

| Raw `snapshot.json` | 6,325,229 bytes | 5,264,366 bytes | -16.8% |

| Gzip (`gzip -n`) | 455,025 bytes | 430,800 bytes | -5.3% |



Sparse v2 omits only schema-enumerated provider/model nulls and defaults. See

[Snapshot Formats and Sparse v2 Rollout](snapshot-formats.md) for the exact

rules, integrity behavior, and packaged-default rollout gate.



## Hex package manifest



The package deliberately includes:



- `lib` and `mix.exs` for runtime code and supported Mix tasks;

- `priv/llm_db/snapshot.json` for zero-network catalog use;

- `config` for the repository-maintainer task defaults retained during the

  compatibility window;

- `guides`, `README.md`, and `CHANGELOG.md` for HexDocs and release history;

- `LICENSE` for licensing.



Repository-only contributor instructions (`AGENTS.md`, `usage-rules.md`) and

the repository formatter configuration (`.formatter.exs`) are excluded. No

runtime module, supported task, guide, source configuration, license, or

packaged metadata is removed.