文件格式转换、文档识别、音频转文字，收藏了一堆各种各样的工具，找起来很麻烦。

filewizard 把这些工具封装到一个可自托管的网页，文件拖进去就能转，只需在浏览器点几下。

底层包了 FFmpeg、LibreOffice、Pandoc 这些成熟工具，格式互转覆盖得很全。

图片和 PDF 能做文字识别，音频靠 Whisper 转成文稿，还带后台任务和实时进度。

GitHub：http://github.com/LoredCast/filewizard…

提供 Docker 本地一键部署方式，项目跑在自己机器上，文件不用传给第三方。

经常要倒腾各种文件格式的朋友，自己搭一个当在线工具箱用。

LoredCast/filewizard

Source: https://github.com/LoredCast/filewizard

File Wizard

A self-hosted, browser-based utility for file conversion, OCR and audio transcription. It wraps common CLI and Python converters (FFmpeg, LibreOffice, Pandoc, ImageMagick, etc.), plus faster-whisper and Tesseract OCR.

Features

• Convert between many file formats; extendable via settings.yml to add any CLI tool.
• OCR for PDFs and images (tesseract / ocrmypdf).
• Audio transcription using Whisper models.
• Simple, responsive dark UI with drag-and-drop and file picker.
• Background job processing with real-time status updates and persistent history.
• /settings page for configuring conversion tools and OAuth (runs without auth in local mode).
• CPU-only by default; a -cuda image is available for GPU use.

Security

Warning: exposing this app publicly without authentication risks arbitrary code execution. Intended for local use or behind a properly configured OAuth/OIDC provider.

Tech stack

FastAPI, vanilla HTML/JS/CSS frontend.

Installation

Recommended — Docker (pull from Docker Hub)

Images available:

• loredcast/filewizard:latest (newest full release without cuda)
• loredcast/filewizard:0.3-small (omits TeX and other large tools)
• loredcast/filewizard:0.3-cuda (CUDA-enabled)

# docker-compose.yml
version: "3.9"
services:
  web:
    image: loredcast/filewizard:latest
    environment:
      - LOCAL_ONLY=True # False for Auth
      - SECRET_KEY= # set if using auth
      - UPLOADS_DIR=/app/uploads # inside the container
      - PROCESSED_DIR=/app/processed # inside the container
      - OMP_NUM_THREADS=1
      - DOWNLOAD_KOKORO_ON_STARTUP=true
    ports:
      - "6969:8000"
    volumes:
      - ./config:/app/config # settings.yml will be here
      - ./uploads_data:/app/uploads
      - ./processed_data:/app/processed
volumes:
  uploads_data: {}
  processed_data: {}

Copy docker-compose.yml from the repo or the above, adjust as needed, then:

docker compose up -d

FileWizard will be available at localhost:6969

Build locally with Docker (new build types)

For different build configurations, use the BUILD_TYPE argument:

# Full build (includes all dependencies but no CUDA)
docker build --build-arg BUILD_TYPE=full -t filewizard:full .

# Small build (excludes TeX and markitdown dependencies for smaller image)
docker build --build-arg BUILD_TYPE=small -t filewizard:small .

# CUDA build (includes CUDA support for GPU acceleration)
docker build --build-arg BUILD_TYPE=cuda -t filewizard:cuda .

Or with docker-compose:

# For full build
docker compose build --build-arg BUILD_TYPE=full

# For small build
docker compose build --build-arg BUILD_TYPE=small

# For CUDA build
docker compose build --build-arg BUILD_TYPE=cuda

For CUDA builds, ensure you have:

• NVIDIA Docker runtime installed (nvidia-docker2 package)
• Compatible GPU with appropriate drivers
• Add the GPU configuration to docker-compose.yml if building with compose:

    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

For troubleshooting GPU issues, make sure:

1. Your GPU drivers support the CUDA version (12.1)
2. cuDNN libraries are properly installed in the container
3. The nvidia-container-toolkit is properly configured
4. Test NVIDIA setup with: docker run --rm --gpus all nvidia/cuda:12.1-base-ubuntu22.04 nvidia-smi

git clone https://github.com/LoredCast/filewizard.git
cd filewizard
docker compose up --build

Note: building can be slow (TeX and other dependencies).

Manual (no Docker)

git clone https://github.com/LoredCast/filewizard.git
cd filewizard
python -m venv venv
source venv/bin/activate   # Windows: venv\\Scripts\\activate
pip install -r requirements.txt
chmod +x run.sh
./run.sh

Dependencies include fastapi, uvicorn, sqlalchemy, huey, faster-whisper, ocrmypdf, pytesseract, python-multipart, pyyaml, etc.

Configuration & docs

See the project Wiki for details and examples:
https://github.com/LoredCast/filewizard/wiki

Usage

1. Open http://127.0.0.1:8000.
2. Drag & drop or choose files.
3. Select action: Convert, OCR, or Transcribe.
4. Track job progress in the History table (updates automatically).

Tools Table

Consider spending 30 seconds on the » usage survey « to help improve the app and suggest changes!