Nhảy tới nội dung

Tải về & cài đặt

Xác định phiên bản phù hợp

Gợi ý

Sau khi phát hành Vnstock3, mã nguồn dự án được chai sẻ qua Github thành 2 nhánh chính riêng biệt. Trong đó main sẽ thể hiện mã nguồn gói Vnstock3, legacy sẽ lưu trữ mã nguồn gói Vnstock thế hệ trước đó cùng trang tài liệu trước khi dự án duy trì một mã nguồn duy nhất là Vnstock3. Trong hầu hết trường hợp bạn có thể sử dụng lệnh cài đặt nhanh từ PyPI. Nếu bạn có nhu cầu cài đặt vnstock từ mã nguồn, bạn cần chọn phiên bản phù hợp và copy câu lệnh tương ứng để thực hiện cài đặt ở bước tiếp theo:

  1. Cài đặt nhanh, sử dụng bản vnstock3 mới nhất được chia sẻ qua pypi.org, sử dụng câu lệnh sau:
    pip install vnstock3
  2. Cài đặt trực tiếp từ mã nguồn có trên Github:

Cài đặt nhánh main (nhận cập nhật mới nhất) cho mã nguồn Vnstock3 nhất là với các thay đổi nhỏ chưa cập nhật riêng thành phiên bản phát hành chính thức.

pip install git+https://github.com/thinh-vu/vnstock.git@main
  1. Nếu bạn muốn sử dụng phiên bản vnstock (legacy) mà chưa có nhu cầu nâng cấp, có thể cài đặt bằng câu lệnh sau:
pip install vnstock

choose a branch

Chạy câu lệnh cài đặt

Khi sử dụng file Demo Notebook để bắt đầu, các câu lệnh cài đặt cần thiết đã được cung cấp sẵn để bạn thực thi (run).

pip được sử dụng để cài đặt vnstock. pip có sẵn trong hầu hết các bản phân phối Python được cài đặt. Phiên bản python cần thiết cho Vnstock3 tối thiểu là 3.10. Bạn có thể paste câu lệnh đã copy ở Bước 1 và chạy nó trong môi trường Python bạn đang sử dụng.

  • Jupyter Notebook/Jupyter Lab/Google Colab: Mở file demo notebook để chạy các lệnh có sẵn.
  • CLI: Mở Terminal (macOS/Linux) hoặc Command Prompt (Windows Desktop) và paste dòng lệnh trên, bấm Enter để cài đặt. Lưu ý: Nếu sử dụng Windows và Python cài đặt với Anaconda thì chọn Anaconda Prompt để chạy lệnh thay vì Command Prompt mặc định.

🔐 Cài đặt gói thư viện nâng cao

Gợi ý

Đối với các thành viên tham gia tài trợ dự án thông qua Insiders Program, các bạn có thêm quyền truy cập vào các kho mã nguồn riêng tư (private repo). Mỗi gói cài đặt bổ sung này sẽ có hướng dẫn kèm theo trong file README của repo đó trên Github.

Cài đặt các gói thư viện bắt buộc (gỡ lỗi)

Lưu ý

Trong quá trình cài đặt gói phần mềm Vnstock3 với pip, các gói phụ thuộc sẽ được tự động cài đặt, bạn không cần làm gì thêm. Nếu trong trường hợp cài đặt không thành công, bạn có thể cài đặt thủ công với file requirements.txt như hướng dẫn dứoi đây.

Để quá trình cài đặt diễn ra đơn giản và suôn sẻ, bạn có thể làm theo các bước sau:

  • Tải file requirement.txt về máy

  • Mở Command Prompt / Terminal, trỏ tới thư mục chứa file requirements.txt, thông thường là Downloads bằng lệnh:

    cd  ĐỊA_CHỈ_THƯ_MỤC_CỦA_BẠN
  • Chạy lệnh sau:

    pip install -r requirements.txt

Như vậy là quá trình chuẩn bị để sử dụng vnstock đã hoàn thành. Chúc bạn thành công!