jsonfix-llm

Repair broken JSON from LLM outputs. Stop fighting malformed JSON.

Install

pip install jsonfix-llm

Quick Start

from jsonfix_llm import repair_json

fixed = repair_json("""{
  'name': 'shashi'
  'age': 25
}""")
# {"name": "shashi", "age": 25}

Features

• Markdown fence stripping — removes ```json ... ``` wrappers
• Comment stripping — removes // and /* */ comments
• Quote fixing — single quotes → double quotes, unquoted keys → quoted
• Literal fixing — True/False/None → true/false/null
• Comma fixing — inserts missing commas, removes trailing commas
• Value fixing — fills missing values, fixes missing colons
• Control char escaping — escapes literal newlines/tabs in strings
• Bracket auto-close — appends missing } or ], handles truncation
• Code extraction — extracts code from fenced, indented, inline, and XML blocks
• CLI tool — quick repair from the terminal

API

from jsonfix_llm import repair_json, extract_code, extract_json

# Simple repair
fixed = repair_json(text)

# Rich result
result = repair_json(text, rich=True)
print(result.fixed)
print(result.was_repaired)
print(result.fixes)
print(result.error_count)
print(result.errors)

# Extract code (default: first Python block)
code = extract_code(text)
# language-specific: extract_code(text, language="python")
# all blocks: extract_code(text, language="json", all=True)

# Extract JSON blocks
json_block = extract_json(text)
json_blocks = extract_json(text, all=True)

CLI

# Repair JSON file
jsonfix broken.json

# Read from stdin
echo '{"a":1' | jsonfix

# Write to file
jsonfix in.json -o fixed.json

# Show repair stats
jsonfix in.json --stats

# Extract code blocks
jsonfix extract file.md --language python
jsonfix extract file.md --language python -o output.py
jsonfix extract file.md --language json --all

Development

pip install -e ".[dev]"
pytest tests/ -v

Publishing to PyPI

First-time setup

pip install build twine

Create an account at pypi.org and generate an API token at https://pypi.org/manage/account/token/.

First-time publish

python -m build
twine upload dist/*
# Username: __token__
# Password: <your-pypi-token>

Bug fix release (patch)

After fixing a bug:

1. Bump the patch version in pyproject.toml:

   version = "0.1.0"  →  version = "0.1.1"
   

2. Build & upload:

   python -m build
   twine upload dist/*
   

3. Commit & push:

   git add -A
   git commit -m "Bump version to 0.1.1"
   git push
   

New feature release (minor / major)

1. Bump version in pyproject.toml (semver: MAJOR.MINOR.PATCH):
   • New feature: 0.1.0 → 0.2.0
   • Breaking change: 0.1.0 → 1.0.0
2. Update CHANGELOG.md
3. Build, upload, commit & push (same steps as above)

Note: PyPI does not allow re-uploading the same version. Always bump before uploading.