AutoPublish

AutoPublish is an offline DOCX publication formatter for editors, academic teams, and publishers. It uses a local FastAPI engine for deterministic parsing/classification and a React/Vite operator console for review and export. No manuscript content is sent to a cloud service.

Run locally

Requirements: Python 3.10+ and Node.js 18+.

cd backend
python -m pip install -r requirements.txt
python main.py

In a second terminal:

cd frontend
npm install
npm run dev

Open the Vite URL shown in the terminal. The backend listens on http://127.0.0.1:8000.

Demo path

1. Click Run guided demo on the Overview screen.
2. Review the detected structure map and confidence values.
3. Open the style panel and switch between Academic Modern and Classic Press.
4. Open Diagnostics to show the local validation log.
5. Click Export .docx and open the generated Word file.

The real import flow accepts .docx files by drag-and-drop or file picker. Ctrl/Cmd+O opens import and Ctrl/Cmd+E exports the current run.

Architecture

• backend/parser.py: extracts Word paragraphs, tables, inline properties, and metadata.
• backend/classifier.py: explainable feature-based structural classification.
• backend/formatter.py: deterministic publication styles and valid Word-compatible output.
• backend/main.py: local REST API for analyze, sample, preset, and format operations.
• frontend/src/App.tsx: dashboard, workbench, preview, history, diagnostics, and export UX.

The formatter preserves source text and only changes document structure and presentation. The backend includes sample generation and tests in backend/test_backend.py.