7 ms·
I built a PDF text extraction library in Zig that's significantly faster than MuPDF for text extraction workloads. ~41K pages/sec peak throughput. Key choices
by lulzx 9mo ago
I built a PDF text extraction library in Zig that's significantly faster than MuPDF for text extraction workloads.
~41K pages/sec peak throughput.
Key choices: memory-mapped I/O, SIMD string search, parallel page extraction, streaming output. Handles CID fonts, incremental updates, all common compression filters.
~5,000 lines, no dependencies, compiles in <2s.
Why it's fast:
- Memory-mapped file I/O (no read syscalls)
- Zero-copy parsing where possible
- SIMD-accelerated string search for finding PDF structures
- Parallel extraction across pages using Zig's thread pool
- Streaming output (no intermediate allocations for extracted text)
What it handles:
- XRef tables and streams (PDF 1.5+)
- Incremental PDF updates (/Prev chain)
- FlateDecode, ASCII85, LZW, RunLength decompression
- Font encodings: WinAnsi, MacRoman, ToUnicode CMap
- CID fonts (Type0, Identity-H/V, UTF-16BE with surrogate pairs)
- littlestymaar 9mo ago> I built You didn't. Claude did. Like it did write this comment. And you didn't even bother testing it before submitting, which is insulting to everyone.
- lulzx 9mo agotools are tools.
- tveita 9mo agoWhat kind of performance are you seeing with/without SIMD enabled? From https://github.com/Lulzx/zpdf/blob/main/src/main.zig https://github.com/Lulzx/zpdf/blob/main/src/main.zig it looks like the help text cites an unimplemented "-j" option to enable multiple threads. There is a "--parallel" option, but that is only implemented for the "bench" command.
- lulzx 9mo agoI have now made parallel by default and added an option to enable multiple threads. I haven't tested without SIMD.
- cheshire_cat 9mo agoYou've released quite a few projects lately, very impressive. Are you using LLMs for parts of the coding? What's your work flow when approaching a new project like this?
- littlestymaar 9mo ago> Are you using LLMs for parts of the coding? I can't talk about the code, but the readme and commit messages are most likely LLM-generated. And when you take into account that the first commit happened just three hours ago, it feels like the entire project has been vibe coded.
- Neywiny 9mo agoHard disagree. Initial commit was 6k LOC. Author could've spent years before committing. Ill advised but not impossible.
- littlestymaar 9mo agoWhy would you make Claude write your commit message for a commit you've spent years working on though?
- Neywiny 9mo ago1. Be not good at or a fan of git when coding 2. Be not good at or a fan of git when committing Not sure what the disconnect is. Now if it were vibecoded, I wouldn't be surprised. But benefit of the doubt
- Jach 9mo agoWe're well beyond benefit of the doubt these days. If it looks like a duck... For me there wasn't any doubt, the author's first top comment here was evidence enough, then seeing the readme + random code + random commit message, it's all obvious LLM-speak to me. I don't particularly care, though, and I'm more positive about LLMs than negative even if I don't (yet?) use them very much. I think it's hilarious that a few people asked for Python bindings and then bam, done, and one person is like "..wha?" Yes, LLMs can do that sort of grunt work now! How cool, if kind of pointless. Couldn't the cycles have just been spent on trying to make muPDF better? Though I see they're in C and AGPL, I suppose either is motivation enough to do a rewrite instead. (This is MIT Licensed though it's still unclear to me how 100% or even large-% vibe-coded code deserves any copyright protection, I think all such should generally be under the Unlicense/public domain.) If the intent of "benefit of the doubt" is to reduce people having a freak out over anyone who dares use these tools, I get that.
- jeffbee 9mo agoWhat's fast about mmap?
- rishabhaiover 9mo agoit allows the program to reference memory without having to manage it in the heap space. it would make the program faster in a memory managed language, otherwise it would reduce the memory footprint consumed by the program.
- jeffbee 9mo agoYou mean it converts an expression like `buf[i]` into a baroque sequence of CPU exception paths, potentially involving a trap back into the kernel.
- rishabhaiover 9mo agoI don't fully understand the under the hood mechanics of mmap, but I can sense that you're trying to convey that mmap shouldn't be used a blanket optimization technique as there are tradeoffs in terms of page fault overheads (being at the mercy of OS page cache mechanics)
- jibal 9mo agoI think he's conveying that he doesn't know what he's talking about. buf[i] generates the same code regardless of whether mmap is being used. The first access to a page will cause a trap that loads the page into memory, but this is also true if the memory is read into.
- StilesCrisis 9mo agoTradeoffs such as "if an I/O error occurs, the program immediately segfaults." Also, I doubt you're I/O bound to the point where mmap noticeably better than read, but I guess it's fine for an experiment.
- 9mo ago
- jonstewart 9mo agoWhat’s the fidelity like compared to tika?
- lulzx 9mo agoThe accuracy difference is marginal (1-2%) but the speed difference is massive.
- DannyBee 9mo agoFWIW - mupdf is simply not fast. I've done lots of pdf indexing apps, and mupdf is by far the slowest and least able to open valid pdfs when it came to text extraction. It also takes tons of memory. a better speed comparison would either be multi-process pdfium (since pdfium was forked from foxit before multi-thread support, you can't thread it), multi-threaded foxit, or something like syncfusion (which is quite fast and supports multiple threads). Or even single thread pdfium vs single thread your-code. These were always the fastest/best options. I can (and do) achieve 41k pages/sec or better on these options. The other thing it doesn't appear you mention is whether you handle putting the words in reading order (IE how they appear on the page), or only stream order (which varies in its relation to apperance order) . If it's only stream order, sure, that's really fast to do. But also not anywhere near as helpful as reading order, which is what other text-extraction engines do. Looking at the code, it looks like the code to do reading order exists, but is not what is being benchmarked or used by default? If so, this is really comparing apples and oranges.