# mlc-ai/web-llm · RepoSense Release & Migration Intelligence

> Upgrade `@mlc-ai/web-runtime` to `0.28.0-dev1`. Pre-release build; test in staging. Migration: Low.

## Metadata
- **Repository URL**: https://github.com/mlc-ai/web-llm
- **Primary Package**: `@mlc-ai/web-llm` (NPM)
- **Categories**: `LOCAL-AI`, `RUNTIME`, `FRAMEWORK`
- **Latest Version**: `v0.2.87`
- **Semantic Status**: `WARNING`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/mlc-ai/web-llm/releases.atom

## The Human Context (Plain-English Pitch)
@mlc-ai/web-llm is an open-source library and developer tool in the mlc-ai/web-llm ecosystem. It saves developers from writing repetitive low-level boilerplate from scratch by providing a battle-tested, open-source implementation ready for production.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Upgrade `@mlc-ai/web-runtime` to `0.28.0-dev1`. Pre-release build; test in staging. Migration: Low.

## Breaking Changes & Required Actions
- Upgrade `@mlc-ai/web-runtime` to `0.28.0-dev1`
- Update model binaries to `v0_2_87`, including subgroup variants
- Improve Gemma 4 q4f32 prefill performance
- Fix sliding-window KV cache handling

## Migration Snippet
```ts
npm install @mlc-ai/web-llm@0.2.87
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **TypeScript 5.x** [`COMPATIBLE`]: Ships standard TypeScript declaration files without type regressions.

## Zero-Noise Release Timeline
- **v0.2.87** (2026-10-30) [WARNING]: Upgrade `@mlc-ai/web-runtime` to `0.28.0-dev1`. Pre-release build; test in staging. Migration: Low.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is mlc-ai/web-llm v0.2.87 safe to upgrade in production?
mlc-ai/web-llm v0.2.87 is classified as WARNING (PRERELEASE release). Upgrade `@mlc-ai/web-runtime` to `0.28.0-dev1`. Pre-release build; test in staging. Migration: Low.

### What breaking changes or compatibility risks exist in mlc-ai/web-llm v0.2.87?
No breaking API changes or peer dependency conflicts are recorded for mlc-ai/web-llm v0.2.87 in the RepoSense compatibility graph.

### What is the bundle size impact of @mlc-ai/web-llm v0.2.87?
Measured bundle size telemetry is currently unavailable for @mlc-ai/web-llm v0.2.87; verify build output locally before deploying.

### How do I upgrade @mlc-ai/web-llm to v0.2.87?
Upgrade @mlc-ai/web-llm to v0.2.87 by running "npm install @mlc-ai/web-llm@0.2.87" and applying the migration steps: npm install @mlc-ai/web-llm@0.2.87