fylzap

Convert files from your terminal — PDF, DOCX, images and more.

Install

npm install -g fylzap
# or run without installing:
npx fylzap document.pdf

Setup

Get your API key from fylzap.com/dashboard, then:

fylzap config --key fc_live_your_key_here

Usage

```bash

Convert PDF to Markdown

fylzap document.pdf

Specify output format

fylzap document.pdf --output txt

Convert image with OCR

fylzap scan.png --output txt --language eng

Save to specific directory

fylzap document.pdf --out-dir ./output

Use AI mode for better PDF quality

fylzap document.pdf --ai

AI Clean post-processing pass

fylzap document.pdf --output md --clean

Split into chapters

fylzap document.pdf --output md --chapters

Generate a full AI-ready Knowledge Pack

fylzap document.pdf --knowledge

Batch Knowledge Pack (Enterprise plan)

fylzap doc1.pdf doc2.pdf doc3.docx --knowledge

Return immediately without waiting for completion

fylzap document.pdf --ai --async fylzap status fylzap download

Multiple files

fylzap *.pdf --output md --out-dir ./converted

One-time key (without saving)

fylzap document.pdf --key fc_live_xxx ```

Large files and AI/Knowledge Pack conversions are uploaded directly to avoid request size limits — this happens automatically, no extra flags needed.

Supported Formats

| Input | Output | |-------|--------| | PDF | Markdown, Text, JSON, PNG, JPG | | Word (DOCX) | Markdown, Text | | Markdown (MD) | PDF, EPUB | | LaTeX (.tex) | PDF | | CSV | JSON | | JSON | CSV | | OpenAPI/YAML | Markdown | | Images (JPG, PNG, WEBP, etc.) | Text (OCR) |

Knowledge Pack (--knowledge) supports PDF, DOCX, and Markdown input and produces a ZIP with README, metadata, TOC, summary, chunks, chapters, and images.

Commands

| Command | Description | |---------|-------------| | fylzap <file...> | Convert one or more files | | fylzap config --key <key> | Save API key | | fylzap config --url <url> | Set a custom API URL (self-hosted) | | fylzap config --show | Show current config | | fylzap config --clear | Clear all saved config | | fylzap formats | List supported formats and flags | | fylzap status <jobId> | Check a queued job's status | | fylzap download <jobId> | Download a completed job's result |

Environment Variables

FYLZAP_API_KEY=fc_live_xxx   # API key
FYLZAP_API_URL=https://...   # Custom API URL