README.md

metadata

title: LaTeX Editor
emoji: 📄
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.12.0
app_file: app.py
pinned: false
license: mit

LaTeX Editor

A real-time LaTeX editor with instant PDF preview, optimized for speed and concurrency.

Features

• Live Preview: See your PDF update as you type (500ms debounce)
• Syntax Highlighting: Full LaTeX syntax highlighting with Dracula theme
• Fast Compilation: ProcessPoolExecutor for parallel compilations
• Caching: LRU cache skips recompilation for identical content
• Resizable Panels: Drag the divider to adjust editor/preview ratio
• Zoom Controls: Zoom in/out on the PDF preview

Local Development

1. Install TeX Live:

   # macOS
   brew install --cask mactex
   
   # Ubuntu/Debian
   sudo apt-get install texlive-latex-base texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra
   

2. Install Python dependencies:

   pip install -r requirements.txt
   

3. Run the server:

   python app.py
   

4. Open http://localhost:7860

Deployment on Hugging Face Spaces

The packages.txt file automatically installs TeX Live packages when deployed to HF Spaces.

Architecture

┌─────────────────┐     WebSocket      ┌──────────────────────┐
│  Browser        │◄──────────────────►│  FastAPI Server      │
│  - CodeMirror   │                    │  - WebSocket Handler │
│  - PDF.js       │                    │  - ProcessPoolExec   │
└─────────────────┘                    │  - LRU Cache         │
                                       └──────────┬───────────┘
                                                  │
                                                  ▼
                                       ┌──────────────────────┐
                                       │  pdflatex            │
                                       │  (parallel workers)  │
                                       └──────────────────────┘

Tech Stack

• Backend: FastAPI + uvicorn
• Frontend: Vanilla JS + CodeMirror 5 + PDF.js
• Compilation: pdflatex (TeX Live)