mafintosh/csv-parser — explained in plain English
Analysis updated 2026-07-17 · repo last pushed 2026-05-07
Process a user-uploaded CSV of contacts into database-ready JSON objects without loading the whole file into memory.
Pipe a CSV file through the command-line tool to instantly convert it to JSON in the terminal.
Parse large CSV files at high speed using a streaming approach that avoids memory crashes.
Transform data on the fly by renaming headers or modifying values as rows are read.
| mafintosh/csv-parser | iptv-org/database | gaearon/flux-react-router-example | |
|---|---|---|---|
| Stars | 1,500 | 1,481 | 1,420 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | 2026-05-07 | 2026-06-21 | 2017-08-25 |
| Maintenance | Maintained | Active | Dormant |
| Setup difficulty | easy | easy | easy |
| Complexity | 1/5 | 1/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires a relatively recent Node.js version, unusual text encodings may need extra handling.
csv-parser is a JavaScript tool that takes CSV files (the kind you might open in Excel or Google Sheets) and converts them into JSON objects that code can easily work with. Its main selling point is speed: it can chew through roughly 90,000 rows per second, making it a strong choice when you need to process large data files without waiting around. The tool works using a "streaming" approach. Instead of trying to load an entire massive CSV file into memory all at once (which could crash your application), it reads the file in chunks, row by row, and converts each row into a JavaScript object as it goes. You point it at a file, and it hands you back clean, structured data, like turning NAME,AGE / Daffy Duck,24 into { NAME: "Daffy Duck", AGE: "24" }. It also handles the messy edge cases that make CSV files annoying: quoted fields, comments, different newline formats, and even files without header rows. Someone working on a data import feature for a web app would reach for this. For example, if you are building a product that lets users upload a spreadsheet of customer contacts, this tool reads that file and gives you each row as a tidy object you can save to a database. It also includes a command-line tool, so a data analyst could pipe a file through it in a terminal to instantly convert a CSV into JSON format without writing any code. What stands out is how the project balances raw speed with flexibility. Beyond just parsing, it lets you transform data on the fly, you can rename headers, modify values as they are read, skip comment lines, or handle tab-separated files instead of comma-separated ones. The README is straightforward about its requirements (it needs a relatively recent version of Node.js) and even addresses common headaches like files with unusual text encoding or invisible Byte Order Mark characters that can silently break parsing.
A fast streaming CSV parser for JavaScript that converts CSV files into JSON objects row by row, handling quoted fields, headers, and encoding quirks.
Mainly JavaScript. The stack also includes JavaScript, Node.js.
Maintained — commit in last 6 months (last push 2026-05-07).
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.