Cài đặt

Cài bản mặc định

vnstock_chart thuộc nhóm thư viện thế hệ 5, phát hành qua kho gói riêng của Vnstock — không phải PyPI công khai, nên lệnh cài luôn cần --extra-index-url:

Shell

pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock-chart

Bản mặc định đủ để vẽ mọi biểu đồ thường dùng: đường, nến, cột, phân phối, tương quan, heatmap.

Cài thêm treemap và word cloud

Hai biểu đồ treemap() và wordcloud() cần hai gói phụ không bắt buộc với người không dùng tới:

Shell

pip install -U --extra-index-url https://vnstocks.com/api/packages "vnstock-chart[all]"

Nếu gọi treemap() hay wordcloud() mà chưa cài [all], thư viện báo lỗi rõ ràng, chỉ đúng lệnh cần chạy — không phải lần dò từng ModuleNotFoundError.

Kiểm tra bản cài

Python

from vnstock_chart import Chart
print(Chart)  # import được là coi như xong

Yêu cầu

Python 3.10 trở lên.
vnstock thế hệ 5 (từ bản 5.0) nếu bạn muốn lấy dữ liệu bằng Market(), Reference()… vnstock_chart tự nó không gọi mạng, không cần khoá API — bạn đưa DataFrame vào, nó chỉ vẽ.
numpy>=1.24, pandas>=2.0 — không có trần trên, tương thích với vnstock_quant và vnstock_bt cùng bộ.

Lỗi hay gặp

Hiện tượng	Nguyên nhân	Cách xử lý
`Could not find a version that satisfies the requirement vnstock-chart`	Thiếu `--extra-index-url`	Thêm `--extra-index-url https://vnstocks.com/api/packages` vào lệnh `pip install`
`ModuleNotFoundError: No module named 'squarify'` khi gọi `treemap()`	Chưa cài phần mở rộng `[all]`	`pip install "vnstock-chart[all]" --extra-index-url https://vnstocks.com/api/packages`
Vẫn thấy bản `vnstock_ezchart` cũ sau khi cài `vnstock_chart`	Hai tên gói khác nhau, cùng tồn tại độc lập trong môi trường	Gỡ bản cũ nếu không cần: `pip uninstall vnstock_ezchart`