Menu
Quick reference for src/vramgeist/gguf.py parser. Use before editing gguf.py or adding new metadata keys.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Quick reference for src/vramgeist/calc.py — formulas, public functions, gotchas. Use before editing calc.py.
Keep input small. Use before any Read or Grep call when context budget tight.
Pick next unfinished task from TASK_BOARD.md. Use at start of every session and after finishing one task.
One-page repo layout. Use to locate files without globbing. First skill to invoke after pick-task.
Required end-of-response format. Use before submitting any response that edited files.
Break a Tier 3 (🔴) task into 3-5 Tier-2-shaped sub-tasks before editing. Use whenever picked task is Tier 3.
| name | gguf-quickref |
| description | Quick reference for src/vramgeist/gguf.py parser. Use before editing gguf.py or adding new metadata keys. |
gguf.py is 150 lines, defensive binary parser. Read once, refer here after.
| Symbol | Sig | Notes |
|---|---|---|
read_gguf_metadata(path, max_kv=1000, max_key_len=1024, max_str_len=1_000_000) | `(dict | None, warnings[])` |
estimate_model_size_mb(path) | float | Accepts str or Path |
ParserError | exception | Raised on EOF |
magic[4]="GGUF" | version<u32> | tensor_count<u64> | kv_count<u64> | KVs...
KV layout: key_len<u64> key_bytes value_type<u32> value_payload.
| Code | Type | Payload |
|---|---|---|
| 4 | STRING | len<u64> bytes |
| 5 | ARRAY | array_type<u32> array_len<u64> items — only STRING arrays decoded |
| 6,7 | INT32/UINT32 | <u32> |
| 8,9 | INT64/UINT64 | <u64> |
| 10,11 | FLOAT32/FLOAT64 | <f>/<d> |
| 12 | BOOL | <?> 1 byte |
| else | unknown | stops parse, warning appended |
After raw KVs, parser scans STRING values + STRING ARRAY items for key=value substrings (split on \n,;) and adds them to metadata (without overwriting). Used for HF-style metadata blobs.
*.block_count, e.g. llama.block_count, gemma.block_count.
errors="replace" → never raises on bad bytes.read_exact raises ParserError on short read → caught at top level returning (None, [...]).Always test with tests/test_gguf.py tests/test_gguf_deep.py (see validate skill).