- Plugin của Qiusheng Wu (giswqs) vừa lên v0.7.1 ngày 24/04/2026, lần đầu tiên hỗ trợ QGIS 4.0 chạy trên Qt6.
- Một codebase duy nhất bao trùm cả QGIS 3.28 lẫn QGIS 4.x — viết PyQGIS bằng Jupyter notebook, ngay trong dockable panel của QGIS, không cần rời app.
TL;DR
QGIS Notebook plugin v0.7.1 (24/04/2026) là bản đầu tiên tương thích QGIS 4.0 / Qt6, đồng thời vẫn chạy được trên QGIS 3.28+. Bạn render và execute file .ipynb trực tiếp trong một dockable panel ngay trong QGIS, truy cập QgsProject, iface, layer canvas mà không cần Jupyter server riêng. MIT, miễn phí, ~96 sao GitHub, ~3.400 lượt tải lũy kế qua 5 phiên bản trong 4 tháng.
Có gì mới trong v0.7.1
Điểm nâng cấp đáng giá nhất là tag maxQgisVersion = 4.99.0 trong metadata — nghĩa là cùng một plugin giờ chạy được trên cả Qt5 (QGIS 3.x) lẫn Qt6 (QGIS 4.x). Trước đây, mỗi lần Qt nhảy version lớn là toàn bộ hệ sinh thái plugin Python phải port lại; opengeos đã làm trước cộng đồng và ship trong vòng vài ngày sau khi QGIS 4.0 release.
Ngoài ra v0.7.1 kế thừa các cải tiến tích lũy từ 0.4 → 0.6: light theme, clear-output cho từng cell, dropdown snippet cho boilerplate PyQGIS, line-spacing fix trên Linux, và update checker tự động báo khi có version mới.
Vì sao điều này quan trọng
QGIS có Python console từ rất lâu, nhưng console không lưu được lịch sử cell, không xen markdown, không có rich output (bảng pandas, plot matplotlib). Người dùng GIS muốn workflow reproducible thì xưa nay phải mở Jupyter Lab riêng và bridge qua PyQGIS — tức là duplicate môi trường, dễ lệch version Python.
Plugin này gộp đôi: bạn viết notebook ngay cạnh map canvas, dùng đúng Python interpreter mà QGIS đang chạy, và share file .ipynb kèm project QGIS như một artefact tái lập được 100%. Điều này đặc biệt giá trị cho giáo viên, nhà nghiên cứu, và analyst làm tutorial.
Thông số kỹ thuật
| Thuộc tính | Giá trị |
|---|---|
| Phiên bản hiện tại | 0.7.1 (2026-04-24) |
| QGIS tương thích | 3.28 — 4.99 |
| Python yêu cầu | 3.10+ (đi kèm QGIS) |
| Qt | Qt5 & Qt6 (cùng codebase) |
| License | MIT |
| GitHub stars / forks | 96 / 11 |
| Tổng downloads | ~3.400 qua 5 versions |
| Stack | 95% Python, 5% Shell installer |
So sánh với các giải pháp khác
| Tool | Trong UI QGIS | Hai chiều QGIS↔Notebook | QGIS 4.0 | Active dev |
|---|---|---|---|---|
| qgis-notebook-plugin 0.7.1 | ✅ dockable panel | ✅ | ✅ | 5 release / 4 tháng |
| QNotebook (experimental) | ✅ | partial | ❌ | stalled từ 9/2025 |
| 3liz/qgis-nbextension | ❌ (Jupyter side) | partial | ❌ | thấp |
| PyQGIS từ Jupyter standalone | ❌ | 1 chiều | n/a | n/a |
Use cases
- Documentation workflow: kèm
.ipynbvới.qgzđể giảng viên / khách hàng mở ra reproduce 100%. - Prototyping PyQGIS nhanh: dropdown snippet có sẵn pattern lặp layer, gọi processing tool — đỡ phải nhớ API.
- Phân tích interactive: chạy cell pandas / geopandas trên dữ liệu lấy thẳng từ
QgsProject.instance(), plot matplotlib ngay trong panel. - Dạy học live: instructor demo từng bước, sinh viên nhìn cả map lẫn code trong cùng cửa sổ.
- Plugin developer prototyping: thử idea cho plugin mới ở mức notebook trước khi đóng gói thành plugin chính thức — vòng feedback ngắn hơn nhiều so với reload QGIS mỗi lần đổi code.
Một pattern điển hình: mở project với vài layer vector, viết một cell để thống kê attribute bằng pandas, cell tiếp theo plot kết quả, cell cuối ghi kết quả ngược trở lại thành layer mới qua QgsVectorLayer. Toàn bộ workflow này nằm trong một file .ipynb, version-control bằng Git, và share kèm file .qgz — collaborator chỉ cần cài plugin là chạy lại được không thiếu bước nào.
Hạn chế & chi phí
Plugin miễn phí, MIT. Không paywall.
Lưu ý từ Anita Graser khi review v0.3.0 (1/2026): output cell đôi khi trống dù code chạy được trong console; vài setting (font size, line numbers) chưa thực sự áp dụng; UI còn cơ bản, chưa cho drag-reorder cell. Một số đã được sửa qua các bản 0.4–0.7, nhưng nếu bạn dùng lần đầu nên chuẩn bị tinh thần kernel chỉ có một (Python QGIS bundled), không chọn được kernel khác như Jupyter Lab.
Tiếp theo
Roadmap không công bố chính thức nhưng cadence release hiện tại (5 version trong 4 tháng) cho thấy giswqs vẫn iterate mạnh. Cộng đồng đang chờ: drag-reorder cell, kernel selector, improve độ ổn định của output rendering. Plugin nằm trong bộ opengeos/qgis-plugins — đáng follow nếu bạn làm geospatial Python.
Cài đặt: trong QGIS, mở Plugin Manager → Settings → thêm repo https://qgis.gishub.org/plugins.xml → search "Notebook".
Nguồn: GitHub opengeos/qgis-notebook-plugin, QGIS Plugin Repository, Anita Graser review, video tutorial.
