drzippie/swaipy-converter repository overview

# 1. Create your env file and set at least one API token
cp .env.example .env
python -c "import secrets; print('SWAIPY_API_TOKENS=' + secrets.token_urlsafe(32))" >> .env

# 2. Build and run
docker compose up --build

TOKEN=your-token-here
BASE=http://localhost:8000

# 1. PDF -> Markdown
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=pdf" -F "to=markdown" \
  -F "[email protected]" \
  "$BASE/convert" -o output.md

# 1b. PDF -> Markdown, disabling OCR (faster for text-only PDFs)
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=pdf" -F "to=markdown" \
  -F 'options={"do_ocr": false}' \
  -F "[email protected]" \
  "$BASE/convert" -o output.md

# 2. DOCX -> Markdown
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=docx" -F "to=markdown" \
  -F "[email protected]" \
  "$BASE/convert" -o output.md

# 3. PPTX -> Markdown
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=pptx" -F "to=markdown" \
  -F "[email protected]" \
  "$BASE/convert" -o output.md

# 4. PDF -> HTML (enriched, better layout fidelity than Markdown)
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=pdf" -F "to=html" \
  -F "[email protected]" \
  "$BASE/convert" -o output.html

# 5. Markdown -> PDF (with language + template)
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=markdown" -F "to=pdf" \
  -F 'options={"lang": "es", "template": "report"}' \
  -F "[email protected]" \
  "$BASE/convert" -o output.pdf

# 6. HTML -> PDF
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=html" -F "to=pdf" \
  -F 'options={"template": "compact"}' \
  -F "[email protected]" \
  "$BASE/convert" -o output.pdf

# 7. Markdown -> HTML
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=markdown" -F "to=html" \
  -F "[email protected]" \
  "$BASE/convert" -o output.html

# 8. HTML -> Markdown  (MarkItDown)
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=html" -F "to=markdown" \
  -F "[email protected]" \
  "$BASE/convert" -o output.md

# 9. CSV / JSON / XML / EPUB / XLSX -> Markdown  (MarkItDown; just change 'from')
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "from=csv" -F "to=markdown" \
  -F "[email protected]" \
  "$BASE/convert" -o output.md

# Markdown -> PDF via JSON; decode the returned base64 into a PDF
curl -s -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{
        \"from\": \"markdown\",
        \"to\": \"pdf\",
        \"file_base64\": \"$(base64 -i report.md)\",
        \"options\": { \"lang\": \"es\" }
      }" \
  "$BASE/convert" \
  | python -c "import sys,json,base64; open('output.pdf','wb').write(base64.b64decode(json.load(sys.stdin)['content_base64']))"

// .env
SWAIPY_CONVERTER_URL=http://converter:8000
SWAIPY_CONVERTER_TOKEN=your-token-here

// config/services.php
'swaipy_converter' => [
    'url'   => env('SWAIPY_CONVERTER_URL'),
    'token' => env('SWAIPY_CONVERTER_TOKEN'),
],

use Illuminate\Support\Facades\Http;

$response = Http::withToken(config('services.swaipy_converter.token'))
    ->attach('file', file_get_contents($pdfPath), 'input.pdf')
    ->post(config('services.swaipy_converter.url').'/convert', [
        'from'    => 'pdf',
        'to'      => 'markdown',
        'options' => json_encode(['do_ocr' => true]),
    ]);

$response->throw();
$markdown = $response->body();

$response = Http::withToken(config('services.swaipy_converter.token'))
    ->attach('file', $markdownString, 'report.md')
    ->post(config('services.swaipy_converter.url').'/convert', [
        'from'    => 'markdown',
        'to'      => 'pdf',
        'options' => json_encode(['lang' => 'es']),
    ]);

$response->throw();

// Return as a download, or store it:
return response($response->body(), 200)
    ->header('Content-Type', 'application/pdf')
    ->header('Content-Disposition', 'attachment; filename="document.pdf"');

$response = Http::withToken(config('services.swaipy_converter.token'))
    ->acceptJson()
    ->post(config('services.swaipy_converter.url').'/convert', [
        'from'        => 'markdown',
        'to'          => 'pdf',
        'file_base64' => base64_encode($markdownString),
        'options'     => ['lang' => 'es'],
    ]);

$response->throw();
$pdfBytes = base64_decode($response->json('content_base64'));
Storage::put('documents/report.pdf', $pdfBytes);

$response = Http::withToken(config('services.swaipy_converter.token'))
    ->attach('file', file_get_contents($docxPath), 'input.docx')
    ->post(config('services.swaipy_converter.url').'/convert', [
        'from' => 'docx',
        'to'   => 'markdown',
    ]);

$response->throw();
$markdown = $response->body();

uv sync --extra dev
export SWAIPY_API_TOKENS=dev-token
uv run uvicorn app.main:app --reload

uv run pytest

app/
├── main.py                     FastAPI app, generic /convert dispatch, upload handling
├── auth.py                     Bearer-token dependency (constant-time compare)
├── config.py                   Env-driven settings
└── converters/
    ├── registry.py             (from, to) -> converter mapping + option models
    ├── docling_convert.py       Docling: PDF/DOCX/PPTX -> Markdown or enriched HTML
    ├── markitdown_convert.py    MarkItDown: HTML/CSV/JSON/XML/EPUB/XLSX -> Markdown
    ├── pdf_to_markdown.py        Back-compat shim over docling_convert
    ├── templates.py             Named CSS templates (default / report / compact)
    └── to_pdf.py                Markdown -> HTML -> PDF (WeasyPrint)