git404hub

what is archforge fr?

love-ash/archforge — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A command line linter that scans AI-generated PowerPoint files for invisible defects like broken fonts, overlapping text, and off-canvas content before a human sees the render.

vibe map

mindmap
  root((archforge))
    What it does
      Lints pptx files
      Catches silent font fallback
      Flags off-canvas text
    Tech stack
      Python
      pip package
      GitHub Action
    Use cases
      Check AI-built decks
      Run in CI pipelines
      Auto-fix simple defects
    Audience
      AI agent builders
      Developers
      CI pipeline owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Lint PowerPoint decks generated by an AI agent before showing them to a human.

VIBE 2

Catch silent font fallback issues that break Korean, Chinese, or Japanese text.

VIBE 3

Run automated deck checks in a CI pipeline or pre-commit hook.

VIBE 4

Auto-fix common pptx defects like collisions or off-canvas text.

what's the stack?

PythonpipGitHub Actionspre-commit

how it stacks up fr

love-ash/archforge1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencedeveloperops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Install with pip and run the built in demo command to see it work immediately.

You can use, modify, and distribute this project freely, including for commercial purposes, as long as you keep the copyright notice.

in plain english

archforge is a command line tool that checks PowerPoint files for defects that are invisible until someone actually opens the slide deck. It targets a specific problem: when an AI agent or script builds a .pptx file, PowerPoint will open it without any warning even when something is badly broken, because the flaws live in font resolution, text sizing, and shape positions that only show themselves when the file is rendered. archforge reads the raw .pptx file directly, including its XML, font chain, geometry, and image data, so it does not need PowerPoint installed and can run inside a script or continuous integration pipeline. The tool catches things like text that silently falls back to the wrong font because the intended font is missing the needed characters, a problem especially common with Korean, Chinese, and Japanese text on Latin only fonts. It also flags letter spacing that damages CJK characters, text shrunk below a readable size by autofit, text frames that overlap each other, and text or images that run off the edge of the slide. A separate set of checks looks for signs that a deck was written by an AI model rather than a human, such as dash punctuation used the way language models tend to use it, or repeated buzzwords. Getting started takes one command: installing the package with pip and running a built in demo that builds one broken and one fixed presentation and lints both. From there it can be pointed at a real deck, run across a folder of decks, or asked to output results as JSON for another program to read. It also has a fix mode that automatically repairs some of the simpler problems, and can generate an HTML report or output formats meant for continuous integration systems. archforge ships as a GitHub Action and a pre-commit hook, and it separates its checks into profiles: a core profile with only the objective, mechanical defects, and a full profile that adds the AI-tell and style checks, which is meant for pipelines that lint output from AI writing tools. The font resolution logic behind its main check was built by measuring how real PowerPoint actually resolves fonts, rather than relying only on the file format specification. The project is written in Python and distributed under the MIT license.

prompts (copy fr)

prompt 1
Install archforge and run it against my generated deck.pptx to find layout defects.
prompt 2
Set up archforge as a GitHub Action so every pull request lints its PowerPoint decks.
prompt 3
Use archforge in full profile mode to catch AI-tell punctuation in a machine-generated presentation.
prompt 4
Explain what archforge's E1 font fallback check does and how to fix a flagged slide.

Frequently asked questions

what is archforge fr?

A command line linter that scans AI-generated PowerPoint files for invisible defects like broken fonts, overlapping text, and off-canvas content before a human sees the render.

What language is archforge written in?

Mainly Python. The stack also includes Python, pip, GitHub Actions.

What license does archforge use?

You can use, modify, and distribute this project freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is archforge to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is archforge for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.