altcheck: draft alt text and contrast fixes with a local open vision model

说明与用途

altcheck 是一个命令行工具，可为图像生成草稿 alt 文本并建议对比度修复，帮助自由职业者快速审核并改进客户网页的可访问性。

问题

Freelance web developers need a quick way to identify missing or generic alt text and color‑contrast failures on client pages.

结果

altcheck quickly drafts alt text for missing or generic images and suggests contrast‑fix CSS, producing a reviewable report in about 20 s per image on a 2‑core CPU.

工作流

• 1. Run altcheck <URL> from the command line.
• 2. Playwright loads the page and axe‑core checks the color‑contrast rule.
• 3. For each image, SmolVLM‑500M‑Instruct drafts a short alt sentence and flags decorative images.
• 4. The tool outputs a report.html with drafted alt text and CSS suggestions.
• 5. The developer reviews the drafts and updates the site accordingly.

证据

altcheck is a small command-line tool for freelance web developers. Give it one URL and it writes a local report.html.

来源

Images with a missing, filename-style or generic alt get a drafted alt text. Text that fails the color-contrast check gets a suggested color and a copy-paste CSS fix.

来源

On a 2-core CPU with about 2 GB of RAM, float32 ran out of memory, so it uses bfloat16 there and takes about 20 seconds per image.

来源

A freelancer or small agency fixing client pages. Running it over a page and fixing the obvious gaps takes minutes, so it could be sold as a quick accessibility tidy-up pass.

来源