Code Issues Releases

Releases

v1.0.0 — Initial Release

v1.0.0 · August 26, 2026

main

csv-to-json v1.0.0

A lightweight, zero-dependency CSV-to-JSON converter built for AI agent workflows.

Features

  • Type inference — automatically converts CSV strings to int, float, bool, or null
  • Nested key expansion — dot-notation headers (e.g. user.name) become nested JSON objects
  • Streaming support — process large files row-by-row without loading everything into memory
  • Flexible input — accepts file paths, raw CSV strings, or stdin
  • CLI and library modes — use standalone from the command line or import as a Python module
  • Custom delimiters — supports tabs, pipes, semicolons, or any single character

Usage

python src/csv_converter.py data.csv -o output.json
cat data.csv | python src/csv_converter.py - --expand-keys --compact

Requirements

  • Python 3.10+
  • No external packages