How lagrange-labs/deep-prove works
DeepProve is a zero-knowledge inference system centered on the zkml Rust library, with a CLI/worker client stack, tensor storage, and inspection tooling. The primary workflow is to load and prepare a model, execute inference, then generate and verify a proof; CLI jobs may be run locally or submitted to a remote proving network. The graph also retains the documented model-family/layer coverage, storage backends, and tensor-inspection tool. Edges rely on README-level capability statements or the shown worker/CLI excerpts; unsampled implementation links are omitted where their callers are not evidenced.
Main entry points: prover.rs Proof protocol · main.rs Worker server · proving.rs Worker proving · genstore.rs Tensor store
Components 28
Model preparation
- Model parsers
zkml/src/parser/onnx.rs - Model quantization
zkml/src/quantization/mod.rs - LLM driver
zkml/src/model/llm.rs
Inference engine
- Execution graph
zkml/src/model/exec_graph.rs - Model context
zkml/src/model/context.rs - Inference trace
zkml/src/model/trace.rs - Neural layers
zkml/src/layers/activation.rs - Transformer layers
zkml/src/layers/transformer/mod.rs - Tensor runtime
zkml/src/tensor/mod.rs
Proof system
- Proof protocol
zkml/src/iop/prover.rs - Lookup GKR
zkml/src/lookup/logup_gkr/prover.rs - Polynomial commitment
zkml/src/poly_commit/prover.rs - Proof verifier
zkml/src/iop/verifier.rs
Client stack
- Proving CLI
deep-prove/src/bin/cli/main.rs - Local executor
deep-prove/src/bin/cli/local.rs - Remote submission
deep-prove/src/bin/cli/lpn/http.rs - Worker server
deep-prove/src/bin/worker/main.rs - Worker API
deep-prove/src/bin/worker/api.rs - Worker proving
deep-prove/src/bin/worker/lpn/proving.rs
Storage and inspection
- Proof data store
deep-prove/src/store.rs - Tensor store
tenstore/src/genstore.rs - Local disk backend
tenstore/src/local.rs - Remote backend
tenstore/src/remote/mod.rs - Remote store client
tenstore/src/remote/client.rs - Tensor inspector
tenvis/src/core.rs - Inspection model
tenvis/src/model.rs - Model plotting
tenvis/src/plot.rs
Other components
- User
Connections 28
- User → Proving CLI: submits job
README.md - Proving CLI → Local executor: runs locally
deep-prove/src/bin/cli/main.rs - Proving CLI → Remote submission: submits remotely
deep-prove/src/bin/cli/main.rs - Remote submission → Worker server: dispatches job
- Worker server → Worker API: serves API
deep-prove/src/bin/worker/main.rs - Worker server → Worker proving: runs proving
deep-prove/src/bin/worker/main.rs - Worker proving → Proof data store: loads proof data
deep-prove/src/bin/worker/lpn/mod.rs - Worker proving → Model parsers: parses model
- Model parsers → Model quantization: prepares model
- Model quantization → LLM driver: configures inference
- LLM driver → Model context: runs model
zkml/src/model/llm.rs - Model context → Execution graph: executes graph
- Execution graph → Neural layers: dispatches layers
- Execution graph → Transformer layers: dispatches transformer
- Neural layers → Tensor runtime: operates on tensors
- Transformer layers → Tensor runtime: operates on tensors
- LLM driver → Inference trace: returns trace
zkml/src/model/llm.rs - Worker proving → Proof protocol: proves inference
README.md - Proof protocol → Lookup GKR: uses lookup proofs
- Proof protocol → Polynomial commitment: commits polynomials
- Proof protocol → Proof verifier: supports verification
README.md - Worker server → Tensor store: configures storage
deep-prove/src/bin/worker/main.rs - Tensor store → Local disk backend: uses local backend
tenstore/src/genstore.rs - Tensor store → Remote backend: uses remote backend
tenstore/src/genstore.rs - Remote backend → Remote store client: sends store requests
tenstore/src/remote/mod.rs - Tensor inspector → Inspection model: loads inspection data
tenvis/src/main.rs - Tensor inspector → Model plotting: plots models
tenvis/src/main.rs - Inspection model → Tensor store: reads stored tensors