Skip to content

Getting Started

Raul Montoya Cardenas edited this page Jul 29, 2026 · 2 revisions

Getting Started

Install

[dependencies]
engram-parser = { git = "https://github.com/Limen-Neural/engram-parser", branch = "main" }

No feature flags; no runtime deps.

Load and extract

use engram_parser::{extract_expert, list_experts, load_gguf};

fn main() -> Result<(), engram_parser::ParserError> {
    let layout = load_gguf("./model.gguf")?;
    println!("architecture = {}", layout.metadata.architecture());

    for (block, expert) in list_experts(&layout) {
        let weights = extract_expert(&layout, block, expert)?;
        if let Some(gate) = &weights.gate {
            println!(
                "blk.{block}.expert{expert}.gate: dims={:?} dtype={:?} bytes={}",
                gate.dims, gate.dtype, gate.bytes.len()
            );
        }
    }
    Ok(())
}

In-memory parse (tests)

use engram_parser::parse_bytes;

let layout = parse_bytes(bytes, "mem://fixture".into())?;

Development

cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo build --all-features
cargo test --all-features

# Coverage (optional)
cargo llvm-cov --all-targets --all-features --locked --lcov --output-path lcov.info

Docker

docker build -t engram-parser .
docker run --rm engram-parser
# GHCR (main):
docker pull ghcr.io/limen-neural/engram-parser:main

Next


Last updated: July 29, 2026 Updated by: Grok Build: Grok 4.5 Package tip reference: 07a5558 (main)

Clone this wiki locally