Build a Local Open-Model PagedAttention Memory Headroom Advisor
Model PagedAttention KV-cache memory pressure across open-weight model instances under dynamic prompt loads. Formulate safe continuous batching limits and preemption mitigation strategies using hosted Claude.
What you are building
The core problem, expected build, and operating context for this challenge.
Model PagedAttention KV-cache memory pressure across open-weight model instances under dynamic prompt loads. Formulate safe continuous batching limits and preemption mitigation strategies using hosted Claude.
Local Inference Infrastructure Specialist
Extract active block allocations, KV-cache utilization, and preemption counts from open-weight vLLM serving engine logs.
Compute available KV memory headroom, fragmentation factors, and maximum concurrent token generation limits.
Query hosted Claude via Anthropic API to evaluate memory starvation risks and generate parameter optimization runbooks.
Output structured continuous batching configuration manifests with verified safe concurrency boundaries for cluster operators.
Terminal dashboard and web control console showing block allocator fragmentation, KV-cache fill rates, and configuration diffs.
Simulate 35 sequential vLLM engine log snapshots showing KV block allocation tables, sequence lengths, and GPU memory states. Starter examples below are synthetic. They are not downloaded records.
vLLM open-model serving Extracts PagedAttention KV-cache memory concepts and continuous batching parameters directly from vLLM architecture documentation.
ollama, pydantic. Ollama provides local execution of open-weight benchmark models to generate baseline memory allocation traces without cloud dependencies. Hosted Claude API for expert memory optimization advice; local open models run strictly on test rig.
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.
Calculates KV-cache block utilization and memory fragmentation percentiles with mathematical precision.
Identifies imminent sequence preemption events when KV headroom drops below safety margin.
Emits validated YAML continuous batching parameters compatible with open-source serving runtimes.
```json [ { "input": { "open_model_name": "llama-3-8b-instruct", "gpu_vram_gb": 24, "weights_vram_gb": 16.2, "total_kv_blocks": 500, "allocated_kv_blocks": 475, "incoming_requests_per_sec": 30 }, "expected_output": { "kv_cache_utilization_pct": 95, "remaining_headroom_blocks": 25, "risk_level": "CRITICAL_STARVATION", "recommended_max_num_seqs": 16, "recommended_gpu_memory_utilization": 0.95 } }, { "input": { "open_model_name": "qwen-2.5-7b", "gpu_vram_gb": 40, "weights_vram_gb": 14, "total_kv_blocks": 1600, "allocated_kv_blocks": 400, "incoming_requests_per_sec": 12 }, "expected_output": { "kv_cache_utilization_pct": 25, "remaining_headroom_blocks": 1200, "risk_level": "NOMINAL", "recommended_max_num_seqs": 64, "recommended_gpu_memory_utilization": 0.9 } } ] ```
Applies strictly to locally managed open-weight models. Never attempts to infer memory structure of hosted Claude endpoints. Use mock external writes. Require human review before any real deployment.
Participation guide
Applies strictly to locally managed open-weight models. Never attempts to infer memory structure of hosted Claude endpoints. Use mock external writes and human review.
How work is evaluated
Calculates KV-cache block utilization and memory fragmentation percentiles with mathematical precision. Identifies imminent sequence preemption events when KV headroom drops below safety margin. Emits validated YAML continuous batching parameters compatible with open-source serving runtimes.
Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.
Challenge datasets
Public datasets, plus the private datasets you have access to.
How submissions are scored
These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.
Complete workflow
Extract active block allocations, KV-cache utilization, and preemption counts from open-weight vLLM serving engine logs. Compute available KV memory headroom, fragmentation factors, and maximum concurrent token generation limits. Query hosted Claude via Anthropic API to evaluate memory starvation risks and generate parameter optimization runbooks. Output structured continuous batching configuration manifests with verified safe concurrency boundaries for cluster operators.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Correctness and evidence
Calculates KV-cache block utilization and memory fragmentation percentiles with mathematical precision. Identifies imminent sequence preemption events when KV headroom drops below safety margin. Emits validated YAML continuous batching parameters compatible with open-source serving runtimes.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Review interface
Terminal dashboard and web control console showing block allocator fragmentation, KV-cache fill rates, and configuration diffs.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Safe execution
Applies strictly to locally managed open-weight models. Never attempts to infer memory structure of hosted Claude endpoints.
This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.
What you should walk away with
Extract active block allocations, KV-cache utilization, and preemption counts from open-weight vLLM serving engine logs.
Compute available KV memory headroom, fragmentation factors, and maximum concurrent token generation limits.
Query hosted Claude via Anthropic API to evaluate memory starvation risks and generate parameter optimization runbooks.
Output structured continuous batching configuration manifests with verified safe concurrency boundaries for cluster operators.
Reference links and supporting material
Simulate 35 sequential vLLM engine log snapshots showing KV block allocation tables, sequence lengths, and GPU memory states. Supplied starter examples are synthetic, not source extracts.
Challenge setup
Configuration summary for this challenge.
Challenge input
Input details are not configured.
Ollama
Local LLM runtime for offline inference.
Evaluated output
No output checks are configured.
- Extract active block allocations, KV-cache utilization, and preemption counts from open-weight vLLM serving...
- Calculates KV-cache block utilization and memory fragmentation percentiles with mathematical precision. Ide...
- Terminal dashboard and web control console showing block allocator fragmentation, KV-cache fill rates, and...
- 2 public reference cases
- 1 configured tool
Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.
View technical recipe
Configured tools
- Ollama · Optional
Evaluation contract
- Complete workflow · Weight 40
- Correctness and evidence · Weight 30
- Review interface · Weight 20
- Safe execution · Weight 10
Reference cases
- 2 public reference cases
Workflow tasks
No workflow tasks are configured.
Recipe freeze marker
No recipe freeze time is recorded.