Nabu PDF
Bộ công cụ PDF desktop (Electron) cho tiếng Việt: xem · ghép · tách trang ·
tách thành nhiều file · gộp nhiều PDF thành một file (chọn nhiều file, sắp
lại thứ tự rồi gộp — không cần mở file trước; cũng vào được từ chuột phải nhiều
file PDF trong Explorer → "Gộp bằng Nabu PDF", hoặc kéo–thả nhiều file vào cửa
sổ app) · chèn · thêm trang trắng · xoay · đánh số trang ·
xoá nhiều trang theo khoảng (từ trang X đến Y, trừ vài trang — khỏi tick chọn) ·
lối tắt tác vụ trang ngay trên thanh công cụ + menu chuột phải trên thumbnail
(thêm trang trắng ngay trên/dưới trang đang trỏ, xoay, tách, xoá) ·
thay trang bằng trang của PDF khác (từ v0.2.72, như PDF24) — chuột phải một trang (hoặc một dải trang liền nhau) → chọn file → tất cả trang của file đó hoặc một khoảng 1-3, 5; dòng tóm tắt báo trước số trang còn lại, một Ctrl+Z là về nguyên bản · chú thích ·
khoanh vùng (chữ nhật / elip / khoanh mây revision — chữ nhật hoặc vẽ mây tự do bằng bút/điểm, chọn nét viền + màu nền + độ mờ nền 0–100% + cỡ vòng mây tuỳ chỉnh — cả bốn sửa/di chuyển/đổi màu/xoá lại được sau khi áp dụng, appearance dạng vector nên phóng to & in vẫn sắc) ·
hình tự do nhiều cạnh (từ v0.2.71) — bấm từng điểm hoặc giữ chuột kéo; Enter/bấm điểm đầu để đóng kín (đóng kín mới tô được nền), Esc để để hở thành đường gấp khúc — cho những thứ chữ nhật và elip không ôm được (khu đất, mảng trần, đoạn ống đi chéo); sửa lại được sau khi áp dụng, lưu dạng vector ·
kéo giãn + sửa từng đỉnh cho nét vẽ tay / mây tự do / hình tự do (từ v0.2.71) — chọn hình là hiện 4 nút góc để phóng to thu nhỏ cả hình (độ dày nét không mảnh đi theo), mây tự do và hình tự do thêm chấm tròn ở mỗi đỉnh để nắn riêng một góc ·
thứ tự chồng của chú thích (từ v0.2.75) — chuột phải lên mục → Đưa lên trên cùng / Đưa lên một lớp / Đưa xuống một lớp / Đưa xuống dưới cùng, hoặc Ctrl+] / Ctrl+[ (+Shift đi hẳn lên/xuống); chọn nhiều mục thì cả nhóm đi cùng, giữ nguyên thứ tự trong nhóm; giữ Alt bấm để chọn mục bị che hẳn dưới một khung; thứ tự được giữ khi Lưu · kiểu nét liền / nét đứt / chấm (từ v0.2.75) — ô Kiểu nét cạnh ô Nét cho khung chữ nhật, elip, nét vẽ tay, hình tự do và mũi tên (mũi tên chỉ đứt phần thân); đi theo file, lưu dạng vector nên phóng to & in vẫn sắc · ghép nhiều trang vào một tờ (từ v0.2.76, miễn phí) — Trang ▾ → Ghép nhiều trang vào một tờ…: 2 hoặc 4 trang trên một tờ A4/A3/Letter (vd 2 trang ngang vào một tờ A4 dọc), tôn trọng /Rotate và CropBox, giữ vector; thay các trang chọn tại chỗ, Ctrl+Z hoàn tác; chú thích/liên kết/ô biểu mẫu trên trang được ghép không được giữ (app báo trước) · sửa chú thích do Acrobat / Foxit / PDF-XChange tạo (từ v0.2.77) — trong Chú thích, khoanh vùng / mây / elip / đường kẻ / mũi tên / đa giác / nét vẽ tay, con dấu & ảnh dán (chỉ đổi /Rect, không chụp lại thành ảnh), hộp văn bản (vẫn là /FreeText của họ), ghi chú dán (bình luận thêm thành /IRT reply thật) và tô sáng (vẫn là /Highlight) là đối tượng sống; cái không đụng tới lưu ra y nguyên; chưa nhập: callout và ghi chú đã có luồng · cột trái Trang / Dấu trang / Chú thích (từ v0.2.77) — tab Chú thích liệt kê mọi chú thích (cả của phần mềm khác) theo trang, tác giả, lọc loại/người, bấm để nhảy; tab Dấu trang đọc mục lục của file; kéo đổi thứ tự trang không còn mất dấu trang / form · mũi tên (nhãn text ở đầu hoặc cuối, cỡ nhãn chỉnh được từ v0.2.79 · kéo 2 đầu để xoay / đổi độ dài, giữ Shift khoá góc 15° · nút Đảo chiều lật mũi nhọn — sửa/di chuyển/xoay lại được sau khi áp dụng) · đo & ghi kích thước (dim — hiệu chuẩn 1 đoạn, các đoạn khác tự ghi theo tỷ lệ; đổi cỡ số đo và độ dày nét từ v0.2.79) · vẽ tay (giữ Shift để nét thành đoạn thẳng, thả ra vẽ tay tiếp — gấp khúc trong cùng một nét; sửa/di chuyển/đổi màu/xoá lại được sau khi áp dụng, lưu dạng vector nên phóng to & in vẫn sắc) · tô sáng theo đoạn chữ được chọn (từ v0.2.71) — bôi đen bằng chuột như trong Word, vệt bám sát từng dòng kể cả khi đoạn chọn bắt đầu/kết thúc giữa dòng, chọn vắt hai trang thành hai vệt; ghi vào file thành annotation /Highlight thật nên mở lại vẫn sửa/xoá được và Foxit/Acrobat liệt kê trong danh sách chú thích (tô sáng theo vùng kiểu cũ vẫn còn, cho bản scan) · dấu ✓ / ✗ (bấm ra cỡ mặc định, kéo để tự chọn cỡ; đổi màu + độ dày nét, mỗi loại nhớ màu riêng; từ v0.2.73 là đối tượng sống — sau khi áp dụng hay mở lại file vẫn chọn / kéo / đổi màu / copy–dán được) · màu và nét mặc định cho chú thích mới đổi được ở Cài đặt (mặc định đỏ #e90000 = RGB 233, 0, 0 và nét 1 pt từ v0.2.73; ✓/tô sáng/che thông tin vẫn giữ màu riêng của chúng) · hộp văn bản (font/đậm/nghiêng/gạch chân/gạch ngang · căn lề trái/giữa/phải/đều · bullet & đánh số · giãn dòng/đoạn/ký tự/từ · co giãn ngang · độ mờ · căn giữa/sát mép trang · xoay chữ theo góc bất kỳ, xoay được cả hộp đã áp dụng và hộp mở lại từ file đã lưu · nền phía sau chữ chọn màu + độ mờ 0–100%, cho chỗ đặt chữ lên ảnh scan hay bản vẽ nhiều nét · tự xuống dòng theo khung (từ v0.2.78): kéo chuột khi đặt hộp hoặc kéo tay nắm để đổi bề rộng, chiều cao tự giãn, xuống dòng trên màn hình đúng y trong file · từ v0.2.79: viền khung (màu / độ dày / nét đứt), sao chép & dán định dạng giữa các hộp (Ctrl+Shift+C / V), ký tự đặc biệt (⌀ ± ° ² × ≤ ≥ …), "Đặt làm mặc định" / "Xoá định dạng", ô Bề rộng khung; bảng Định dạng thu gọn được — sửa/di chuyển lại được sau khi áp dụng) · ghi chú dạng chuỗi bình luận (note-of-note) — comment tiếp được sau khi áp dụng, đọc được ở Foxit/Acrobat, kèm bảng danh sách ghi chú toàn tài liệu (bấm để nhảy tới) · chèn ảnh / chữ ký (đóng dấu 1 lần cho nhiều trang, nhận PNG/JPG/BMP — sửa/di chuyển/đổi cỡ/xoá lại được sau khi áp dụng, giữ Shift khi kéo góc để giữ đúng tỷ lệ; xoay tự do bằng núm tròn phía trên ảnh (giữ Shift nhảy 15°, Esc huỷ) và chuột phải → Xoay trái/phải 90° · Lật ngang/dọc · Đặt lại, từ v0.2.80 — chọn nhiều ảnh thì mỗi ảnh xoay/lật quanh tâm riêng; lưu thẳng vào file không chụp lại thành ảnh nên vẫn sắc nét, mở lại file vẫn sửa tiếp được, Áp nhiều trang và sao chép–dán giữ nguyên góc xoay/lật) ·
chữ ký lưu sẵn (từ v0.2.72) — thiết lập một lần ở Cài đặt → Chữ ký của tôi (xoá nền trắng cho ảnh chụp/scan trên giấy, cắt sát nét ký), rồi chuột phải lên trang → Chèn chữ ký là chữ ký nằm giữa chỗ bấm; app nhớ cỡ lần dùng trước; kho chữ ký mã hoá bằng tài khoản Windows (DPAPI) ·
sao chép / dán vật thể chú thích sang trang khác — và sang hẳn file PDF khác đang mở ở tab/cửa sổ khác (kể cả dấu ✓ / ✗ từ v0.2.69, và ảnh — kể cả ảnh vừa dán từ ảnh chụp màn hình — từ v0.2.72 — copy khi còn trong Chú thích, trước khi bấm Xong · giữ Ctrl bấm để chọn nhiều mục · Ctrl+C / Ctrl+V hoặc menu chuột phải · kéo cả nhóm, đổi màu & nét cả nhóm · clipboard không mất khi bấm Áp dụng · bản dán giữ nguyên vị trí, cỡ chữ, phông, màu và nền, dán vào khổ giấy nhỏ hơn thì cả nhóm tự lùi vào trong tờ · tab đích chưa bật Chỉnh sửa thì app tự bật · lần copy gần nhất luôn thắng — ảnh chụp cũ còn trong clipboard Windows không cướp Ctrl+V nữa) ·
watermark · redact (che thông tin chọn màu) · sửa chữ gốc trong PDF — giữ đúng font, đúng cỡ và đúng nền (kéo ô chữ để di chuyển chữ gốc sang chỗ khác, từ v0.2.73 — chỗ cũ bị xoá thật, có xem trước trước khi Áp dụng; tự dùng lại font hệ thống theo họ, kể cả tên kiểu TimesNewRomanBold; khi phải thay face thì tự khớp lại bề rộng & chiều cao để chữ sửa không dài ra đè chữ bên cạnh; không để lại vệt trắng trên ô bảng có nền; tự OCR lấy lại chữ Việt lỗi font .Vn/mã hoá hỏng trên bản vẽ CAD/Revit; trên bản vẽ nằm ngang (/Rotate) chữ sửa giữ đúng chiều của dòng nó thay — kể cả nhãn kích thước dựng dọc và nhãn dẫn viết chéo; căn trái / giữa / phải theo khoảng của đoạn gốc (từ v0.2.79) — sửa số trong cột tiền căn phải mà không lệch cột — và gạch ngang) ·
Tìm & Thay thế chữ trong cả tài liệu (Ctrl+H) — như Word: gõ từ khoá rồi bấm Tìm, app quét toàn bộ tài liệu và tô sáng mọi vị trí kèm số đếm, rồi Thay từng chỗ lần lượt từ trên xuống (bỏ qua chỗ nào cũng được) hoặc Thay tất cả trong một lần, hoàn tác bằng một Ctrl+Z; có phân biệt hoa/thường và đúng nguyên từ; từ khoá bị chia làm nhiều đoạn định dạng được tô riêng màu vàng và nói rõ là không thay tự động thay vì bỏ qua im lặng; tìm được cả bộ bản vẽ vài trăm trang (tới ~1GB, đi đường nhị phân) và lần tìm sau trên cùng tài liệu gần như tức thì; tìm được cả cụm từ mà PDF vẽ rời từng mẩu (văn bản canh đều / xuất từ CAD); chữ thay thế trên bản vẽ nằm ngang giữ đúng chiều của chỗ nó thay · tạo bản theo mẫu (từ v0.2.78) — từ bộ bản vẽ tháp I1 sinh các file I2, I3… chỉ đổi tên cấu kiện (I1..I6, khớp nguyên mã để I1 không khớp trong I10), danh sách chỗ đổi có tick bỏ, mỗi file được đọc lại kiểm tra trước khi lưu, file đang mở không bị sửa · chữ thay vào bản vẽ CAD/PDFsharp giữ đúng cỡ chữ gốc và tìm lại được (từ v0.2.78) ·
nén (đã bỏ trần 200MB — file lớn đi đường nhị phân, không còn base64; nén file lớn không còn làm treo các thẻ khác vì chạy ở tiến trình riêng, và hộp thoại báo trước ước tính thời gian theo dung lượng + mức nén) · in (kết nối máy in — khổ A4…A0, chọn khoảng trang, mỗi trang luôn gọn trong một tờ) · so sánh 2 file
(văn bản & bản vẽ CAD/Revit — khoanh mây revision vùng thay đổi (tick chọn từng vùng để khoanh, mặc định chọn tất), chồng lớp overlay 2 bản vẽ căn tự động + tô màu khác biệt, phóng to/vừa bề ngang & vừa chiều dọc) ·
tạo PDF tìm-kiếm-được · dịch PDF (AI) giữ layout (PDF có text thật, giữ đúng cột/căn lề trong bảng, xuất file mới; xoá được cả chữ gốc đã chuyển thành nét vẽ — brochure/catalogue xuất từ InDesign/Canva không còn bị bản dịch đè lên bản gốc — và báo rõ trang nào AI không dịch được thay vì lặng lẽ trả về nguyên bản) · xuất PDF → Office (Word/Excel/CSV) ·
mở nhiều tài liệu bằng tab trong một cửa sổ (kéo sắp xếp thứ tự · kéo tách tab ra thành cửa sổ riêng, hoặc thả sang cửa sổ khác · Ctrl+T/Ctrl+W/Ctrl+Tab/Ctrl+1–9) ·
chia đôi màn hình — xem hai tài liệu cạnh nhau trong một cửa sổ (Ctrl+\: khung trái là bản đang sửa, khung phải là khung xem chỉ đọc — mở được chính file đang sửa lần thứ hai để xem trang 40 trong lúc làm trang 5; chỉ đọc nên không có chuyện hai bản lưu đè nhau, và Ctrl+S / In / Undo luôn thuộc về khung chính · mỗi lần bạn lưu thì khung xem tự nạp lại mà giữ nguyên trang đang đọc · kéo rãnh giữa để đổi tỷ lệ, Ctrl+Shift+\ thêm khung thứ ba, bố cục được nhớ khi mở app lần sau) · mở nhiều cửa sổ · "Open with Nabu PDF" (mở PDF trực tiếp từ Windows) · copy/paste ảnh trong trang ·
mở lại phiên trước (bật app là có lại đúng bộ tab lần trước) ·
chọn mở file mới vào tab mới hay cửa sổ mới (Cài đặt → “Mở file mới trong”; áp dụng cho cả nút Mở, kéo–thả và “Open with” từ Windows) ·
xem toàn màn hình (F11) — trọn trang nằm gọn trong màn hình, ẩn hết thanh công cụ, dải thumbnail tự hiện khi rê chuột vào mép trái (F4 để ghim); kèm "vừa cả trang" cho cả khổ lớn A0–A1 ·
công cụ Bàn tay (pan) — kéo để di chuyển trang khi phóng to (phím H, V để quay lại chọn chữ, giữ Space để dùng tạm, kéo nút giữa chuột thì pan được mọi lúc) ·
kéo sắp xếp trang có vạch chỉ khe chèn (thấy rõ trang sẽ nằm giữa hai trang nào trước khi thả) · danh sách trang kéo giãn được (bấm đúp tay nắm để về mặc định) và tuỳ chọn ẩn dải đường dẫn file ·
zoom mượt 20–500% (Ctrl+lăn chuột bám con trỏ theo bước đều, trang bám tay ngay rồi tự làm nét khi bạn dừng — không giật từng nấc như trước; nút ± và Ctrl± cũng bước theo tỷ lệ, nên đều tay ở cả hai đầu dải. Ảnh trang bị giữ trong hạn mức an toàn nên bản vẽ A0–A1 phóng hết cỡ không trắng trang và tốn ít bộ nhớ hơn hẳn) ·
danh sách trang tự trượt theo trang đang đọc (cuộn tài liệu → thumbnail trang đó sáng lên và trượt vào khung nhìn, như Acrobat/Foxit) ·
ẩn trang bằng mật khẩu (chuột phải trang → “Ẩn trang này bằng mật khẩu…”: nội dung trang được mã hoá AES-256-GCM (khoá dẫn xuất PBKDF2-SHA256) và thay bằng trang giữ chỗ có khoá nằm trong chính file đó — số trang không đổi nên mục lục/tham chiếu/số trang đã đánh không lệch, và trang ẩn đi theo trang của nó qua sắp xếp lại / ghép / tách / chuyển sang tài liệu khác; kèm “Xuất bản sao KHÔNG kèm trang ẩn” để gửi ra ngoài. Mất mật khẩu là mất trang — chỉ Nabu PDF mở lại được, phần mềm khác chỉ thấy trang giữ chỗ) ·
tự lưu & khôi phục khi sự cố (máy tắt đột ngột / quên lưu → mở lại mời khôi phục) ·
ký số bằng USB token (VNPT-CA / Viettel-CA / FPT-CA / BKAV… qua kho chứng thư Windows — chữ ký nhìn thấy + dấu thời gian TSA) ·
trang Hướng dẫn sử dụng ngay trong app (Trợ giúp → Hướng dẫn sử dụng · F1 · nút ? — 13 mục theo từng chức năng, mục lục bên trái, ô tìm gõ không dấu vẫn ra, song ngữ Việt / Anh; thay cho các dòng hướng dẫn trước đây chiếm chỗ thường trực trên thanh công cụ) ·
kèm OCR + bóc tách hợp đồng bằng AI. Giao diện song ngữ Việt / Anh, kèm
hai badge trạng thái tách bạch (engine trên máy · API key cho tính năng AI —
chấm đặc là sẵn sàng, chấm rỗng là chưa; bấm vào badge API để nhập key).
Chạy hoàn toàn trên máy (local-first).
Ứng dụng desktop nằm trong desktop/ — xem
desktop/README.md để build bản .exe (NSIS — không còn bản portable).
Phần dưới mô tả pipeline OCR + AI (engine Python dùng chung, cũng chạy được
độc lập qua Web UI Streamlit / CLI).
Tổng quan
Image/PDF → OCR (RapidViet: RapidOCR detect + VietOCR) → AI Agent (Gemini) → Structured Output (JSON/Excel/GSheet/Markdown)
Pipeline:
- Input: Upload ảnh scan hoặc PDF hợp đồng
- OCR: Trích xuất text tiếng Việt bằng RapidViet (RapidOCR detect + VietOCR — nhanh & đúng dấu; Hybrid/RapidOCR/PaddleOCR là tuỳ chọn)
- AI Agent: Gemini phân tích text → trích xuất các trường vào schema cố định
- Output: Lưu JSON, Excel, Google Sheet, hoặc Markdown
Cài đặt
Yêu cầu
- Python 3.10+
- Poppler (cho xử lý PDF):
sudo apt-get install poppler-utils
Setup
# Clone repo
git clone https://github.com/darkend16987/NabuPDF.git
cd NabuPDF
# Tạo virtual environment
python -m venv venv
source venv/bin/activate # Linux/Mac
# venv\Scripts\activate # Windows
# Cài đặt dependencies
pip install -r requirements.txt
# Cấu hình
cp .env.example .env
# Sửa .env: thêm GEMINI_API_KEY
Sử dụng
Web UI (Streamlit)
streamlit run app.py
Mở browser tại http://localhost:8501:
- Nhập Gemini API Key ở sidebar
- Upload ảnh/PDF hợp đồng
- Chọn loại hợp đồng (template)
- Bấm Xử lý
- Xem kết quả và tải file output
CLI
# Xử lý 1 file
python cli.py contract_scan.jpg
# Xử lý nhiều file, chọn template và output format
python cli.py file1.jpg file2.pdf --template mua_ban --output-format all
# Chỉ định engine và API key
python cli.py scan.png --engine rapidocr --api-key YOUR_KEY --verbose
Options:
| Flag | Mô tả | Default |
|---|
--engine | OCR engine: auto, rapidviet, hybrid, rapidocr, paddleocr, vietocr | auto |
--api-key | Gemini API key | từ .env |
--model | Gemini model | gemini-3.5-flash-lite |
--template | Template trường: generic, mua_ban, lao_dong, dich_vu | generic |
--output-format | Output: json, excel, markdown, all | json |
--output-dir | Thư mục output | results/ |
-v | Log chi tiết | off |
Templates trường trích xuất
| Template | Mô tả | Số trường |
|---|
generic | Chung cho mọi loại hợp đồng | 12 |
mua_ban | Hợp đồng mua bán | 19 |
lao_dong | Hợp đồng lao động | 18 |
dich_vu | Hợp đồng dịch vụ | 16 |
Có thể tùy chỉnh trường qua Web UI hoặc truyền JSON custom.
Kiến trúc
Nabu-PDF/
├── app.py # Streamlit Web UI
├── desktop/ # Electron desktop app (Nabu PDF)
├── cli.py # CLI entry point
├── src/
│ ├── pipeline.py # Pipeline orchestrator
│ ├── ocr/
│ │ └── engine.py # OCR engines (RapidOCR, PaddleOCR, VietOCR, Auto)
│ ├── agents/
│ │ ├── gemini_agent.py # Gemini AI extraction agent
│ │ └── field_templates.py # Predefined field templates
│ ├── output/
│ │ └── writer.py # Output writers (JSON, Excel, GSheet, MD)
│ └── utils/
│ ├── config.py # Configuration from .env
│ └── image_processing.py # Image preprocessing
├── templates/ # Contract template schemas
├── uploads/ # Uploaded files (gitignored)
├── results/ # Output files (gitignored)
├── requirements.txt
├── .env.example
└── Dockerfile
OCR Engines
RapidViet (mặc định) ⭐
- Detection bằng RapidOCR (ONNX) + recognition bằng VietOCR — nhanh và đúng dấu
- Detector ONNX chạy detection-only (
use_cls=False, use_rec=False), không cần
paddlepaddle, hết crash mkldnn; VietOCR là engine cục bộ duy nhất đọc đúng dấu chồng
tiếng Việt (ộ/ử/ấ/ề/ị), chạy crop theo batch
- Chạy offline hoàn toàn từ v0.2.70: config + weights VietOCR nằm trong bộ cài
(
models/vietocr/), không còn gọi vocr.vn lúc chạy. Dev lấy model bằng
python tools/fetch_vietocr_model.py (ghim SHA256); npm run build:sidecar tự gọi.
- Số đo thật (78 trang A4 scan @ 200 dpi, CPU, ấm — không phải trang đồ chơi):
detect 1,38 s/trang phẳng · VietOCR 5–26 s/trang tuỳ số dòng (~0,3 s/dòng,
24–124 dòng/trang). Tức VietOCR là ~81 % công việc — muốn nhanh hơn nữa thì phải
export VietOCR sang ONNX, không phải tối ưu detection. Trả về toạ độ cho searchable PDF.
OCR_RAPID_DET_ONLY=0 trả lại pipeline cũ (det+cls+rec) nếu cần đối chứng.
⚠️ Recognizer PP-OCR đa ngữ/latin (RapidOCR EN/LATIN, PaddleOCR 3.x) làm hỏng dấu
tiếng Việt — dict của model thiếu ký tự dấu chồng (ạ/ấ/ộ/ợ/ử...). Vì vậy phần
recognition luôn dùng VietOCR.
ℹ️ Bản desktop (.exe) chỉ đóng gói RapidViet để installer nhẹ (~400MB tiết kiệm).
Các engine hybrid/paddleocr cần cài thêm paddle: pip install paddleocr paddlepaddle.
Hybrid (tuỳ chọn — cần cài paddle)
- Như RapidViet nhưng detection bằng PaddleOCR (load chậm hơn, kéo theo paddlepaddle)
RapidOCR (tuỳ chọn — nhanh, yếu dấu)
- PP-OCR thuần trên ONNX — nhanh nhất nhưng không đọc đúng dấu tiếng Việt (chỉ latin)
PaddleOCR / VietOCR (fallback)
- PaddleOCR: full pipeline, recognizer đa ngữ yếu dấu VN; VietOCR: transformer/dòng, đúng dấu
Auto mode
Ưu tiên RapidViet → Hybrid → RapidOCR → PaddleOCR → VietOCR. Đổi bằng env OCR_ENGINE.
Deploy
Docker
docker build -t nabu-pdf .
docker run -p 8501:8501 -e GEMINI_API_KEY=your_key nabu-pdf
Cloud (Google Cloud Run / AWS)
# Google Cloud Run
gcloud run deploy nabu-pdf \
--source . \
--port 8501 \
--set-env-vars GEMINI_API_KEY=your_key
# Hoặc dùng Dockerfile trên bất kỳ cloud platform nào
Google Sheets Integration
- Tạo Service Account trên Google Cloud Console
- Tải file credentials JSON → đặt tên
credentials.json vào root
- Share Google Sheet với email của Service Account
- Cấu hình trong
.env:
GOOGLE_SHEETS_CREDENTIALS_FILE=credentials.json
GOOGLE_SHEETS_SPREADSHEET_ID=your_sheet_id
OUTPUT_FORMAT=gsheet
License
GNU Affero General Public License v3.0 (AGPL-3.0) — see LICENSE.
© 2026 Tạ Hoàng Nam. Phần mềm miễn phí & mã nguồn mở, không có khóa serial /
kiểm soát máy. Bạn được tự do dùng, sửa, phân phối lại theo điều khoản AGPL-3.0;
mọi bản phân phối (kể cả dạng dịch vụ mạng) phải kèm/đề nghị mã nguồn tương ứng
theo cùng giấy phép.
Vì sao AGPL-3.0?
Ứng dụng nhúng PyMuPDF (render, redaction, sửa chữ gốc, OCR text layer…),
vốn cấp phép AGPL-3.0 (hoặc giấy phép thương mại từ Artifex). Để phân phối
hợp lệ mà không mua giấy phép thương mại, toàn bộ tác phẩm kết hợp được phát
hành dưới giấy phép AGPL-3.0 với mã nguồn mở.
Thư viện bên thứ ba
| Thành phần | Giấy phép |
|---|
| PyMuPDF (fitz) | AGPL-3.0 / Artifex commercial |
| PaddleOCR · VietOCR · pdf.js | Apache-2.0 |
| pdf-lib · Electron | MIT |
| PyTorch | BSD-3-Clause |
| matplotlib | Matplotlib (BSD-style) |
Các giấy phép permissive ở trên tương thích khi kết hợp vào tác phẩm AGPL-3.0.
