B
Baukaalm/optiq
Try the demo · Documentation · Benchmarks
updated 2026-10-29
View on GitHub ↗Direct link · no redirect page
We have no copy-paste install command and no public remote endpoint, so we do not print a config. The step above is reference only, not a command we can vouch for. A made-up one is worse than none. How each client wires MCP up →
- Star count
- 0 ★ · Baukaalm/optiq · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
Baukaalm/optiq;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
Optiq
Excerpted from the repository README (abridged)
Try the demo · Documentation · Benchmarks
Browser-side image optimisation for uploads. For every image Optiq encodes a bounded set of candidates
(jpegli, libwebp, libavif, oxipng — compiled to WebAssembly), measures each one, and returns the smallest
output that satisfies your constraint:
lossless — decoded pixels (including alpha) are verified identical to the input;
visually-lossless — pixels may differ; SSIM ≥ 0.99 against the input (configurable);
balanced (default) — SSIM ≥ 0.975, smaller search budget, faster AVIF preset.
AVIF is held to a stricter SSIM threshold than JPEG and WebP. It was calibrated against the independent SSIMULACRA2
metric, which showed SSIM is too lenient on AVIF's smoothing.
The same engine also runs in Node and powers:
a CLI (npx optiq-image);
a Vite plugin;
an MCP server for AI agents (optiq-mcp, source in mcp/).
In the browser, work runs in a Web Worker; the main thread only posts a Blob and receives an ArrayBuffer. Results carry the
chosen codec/settings, every candidate tried, the measured quality, warnings, fallbacks and unmet constraints.
> Benchmarks: see Benchmark results and bench/results/RESULTS.md. Optiq is not
> uniformly better than the alternatives; the trade-offs (size vs. time vs. memory) are listed there per category.
## Install
sh
pnpm add optiq-image # or npm / yarn
Requirements: an ES2022 browser with module Workers and WebAssembly (Chrome/Edge 80+, Firefox 114+, Safari 15+).
AVIF output is only useful where your audience can decode AVIF (Chrome 85+, Firefox 93+, Safari 16.4+); remove it
with autoFormats: ["jpeg", "png", "webp"] otherwise.
### Bundler setup (Vite 7 and 8)
ts
// vite.config.ts
export default defineConfig({
worker: { format: "es" }, // codecs are loaded with dynamic import() inside the worker
optimizeDeps: { // dev only: pre-bundling breaks new URL("x.wasm", import.meta.url)
exclude: ["optiq-image", "@jsquash/jpeg", "@jsquash/png", "@jsquash/webp", "@jsquash/avif", "@jsquash/oxipng", "@jsquash/resize"],
},
});
webpack 5 and Parcel 2 understand new Worker(new URL("./worker.js", import.meta.url), { type: "module" }) and
new URL(".wasm", import.meta.url) natively. For anything else pass workerFactory to createCompressor.
Each codec is a separate chunk, fetched on first use (AVIF ≈ 3.5 MB, others 35–350 KB).
## Usage
ts
import { compressImage, isOptiqError } from "optiq-image";
const controller = new AbortController();
try {
const result = await compressImage(file, {
mode: "balanced",
maxWidthOrHeight: 2560,
signal: controller.signal,
onProgress: (e) => console.log(e.stage, Math.round(e.progress 100), e.bestBytes),
});
result.blob; // Blob with the right MIME type (image/avif, image/webp, ...)
result.fileName; // "IMG_0042.webp" — extension matches the encoded bytes
result.sizeReductionRatio, result.qualityMetric, result.codec, result.warnings;
if (!result.constraintsMet) console.warn(result.unmetConstraints);
} catch (e) {
if (isOptiqError(e)) console.warn(e.code, e.message); // e.g. UNSUPPORTED_FORMAT, ABORTED
// the original file is untouched — upload it instead
React:
tsx
function useCompressed(file?: File) {
const [state, set] = useState ({ progress: 0 });
Browser-side image optimisation for uploads. For every image Optiq encodes a bounded set of candidates
(jpegli, libwebp, libavif, oxipng — compiled to WebAssembly), measures each one, and returns the smallest
output that satisfies your constraint:
lossless — decoded pixels (including alpha) are verified identical to the input;
visually-lossless — pixels may differ; SSIM ≥ 0.99 against the input (configurable);
balanced (default) — SSIM ≥ 0.975, smaller search budget, faster AVIF preset.
AVIF is held to a stricter SSIM threshold than JPEG and WebP. It was calibrated against the independent SSIMULACRA2
metric, which showed SSIM is too lenient on AVIF's smoothing.
The same engine also runs in Node and powers:
a CLI (npx optiq-image);
a Vite plugin;
an MCP server for AI agents (optiq-mcp, source in mcp/).
In the browser, work runs in a Web Worker; the main thread only posts a Blob and receives an ArrayBuffer. Results carry the
chosen codec/settings, every candidate tried, the measured quality, warnings, fallbacks and unmet constraints.
> Benchmarks: see Benchmark results and bench/results/RESULTS.md. Optiq is not
> uniformly better than the alternatives; the trade-offs (size vs. time vs. memory) are listed there per category.
## Install
sh
pnpm add optiq-image # or npm / yarn
Requirements: an ES2022 browser with module Workers and WebAssembly (Chrome/Edge 80+, Firefox 114+, Safari 15+).
AVIF output is only useful where your audience can decode AVIF (Chrome 85+, Firefox 93+, Safari 16.4+); remove it
with autoFormats: ["jpeg", "png", "webp"] otherwise.
### Bundler setup (Vite 7 and 8)
ts
// vite.config.ts
export default defineConfig({
worker: { format: "es" }, // codecs are loaded with dynamic import() inside the worker
optimizeDeps: { // dev only: pre-bundling breaks new URL("x.wasm", import.meta.url)
exclude: ["optiq-image", "@jsquash/jpeg", "@jsquash/png", "@jsquash/webp", "@jsquash/avif", "@jsquash/oxipng", "@jsquash/resize"],
},
});
webpack 5 and Parcel 2 understand new Worker(new URL("./worker.js", import.meta.url), { type: "module" }) and
new URL(".wasm", import.meta.url) natively. For anything else pass workerFactory to createCompressor.
Each codec is a separate chunk, fetched on first use (AVIF ≈ 3.5 MB, others 35–350 KB).
## Usage
ts
import { compressImage, isOptiqError } from "optiq-image";
const controller = new AbortController();
try {
const result = await compressImage(file, {
mode: "balanced",
maxWidthOrHeight: 2560,
signal: controller.signal,
onProgress: (e) => console.log(e.stage, Math.round(e.progress 100), e.bestBytes),
});
result.blob; // Blob with the right MIME type (image/avif, image/webp, ...)
result.fileName; // "IMG_0042.webp" — extension matches the encoded bytes
result.sizeReductionRatio, result.qualityMetric, result.codec, result.warnings;
if (!result.constraintsMet) console.warn(result.unmetConstraints);
} catch (e) {
if (isOptiqError(e)) console.warn(e.code, e.message); // e.g. UNSUPPORTED_FORMAT, ABORTED
// the original file is untouched — upload it instead
React:
tsx
function useCompressed(file?: File) {
const [state, set] = useState ({ progress: 0 });
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/baukaalm-optiq/)
- Source
- awesome · https://github.com/Baukaalm/optiq
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.