Nhảy tới nội dung

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

Sử dụng file cài đặt OneClick​

"Thông tin"

Vnstock hướng đến trải nghiệm đơn giản và dễ dàng nhất có thể tới bạn, dù bạn chưa rành về lập trình hay sử dụng Python từ trước. Trên các môi trường đã có sẵn python như Google Colab, bạn chỉ cần chạy câu lệnh pip install -U vnstock3 để cài đặt phần mềm này. Nếu bạn vẫn cần sử dụng Vnstock trên môi máy tính cá nhân với môi trường cục bộ, việc cài đặt đã trở nên đơn giản với vài nhấp chuột bằng cách sử dụng tập lệnh (script) cài đặt như hướng dẫn dưới đây. Tập lệnh cài đặt này giúp bạn cài đặt đầy đủ cả Python, Visual Studio Code và Vnstock3 trên một máy tính mới để sẵn sàng sử dụng.

Thao tác trên Windows

Để thực hiện cài đặt chương trình với PowerShell, bạn có thể mở Powershell bằng cách nhấp chuột phải vào biểu tượng Windows trên thanh Taskbar của máy tính sau đó chọn Windows PowerShell (Admin) và thực hiện tiếp các lệnh sau.

  1. Mở PowerShell từ thư mục chứa file cài đặt, giả sử địa chỉ lưu file mặc định là thư mục Downloads.
cd Downloads
  1. Chạy lệnh cài đặt từ file script.
powershell -ExecutionPolicy Bypass -File .\oneclick_python_vnstock3_windows.ps1
Thao tác trên macOS

Bạn cần mở ứng dụng Terminal trên máy tính Mac thông qua Launchpad hoặc sử dụng tổ hợp phím tắt Cmd + Space sau đó nhập Terminal để tìm kiếm, chọn và Enter. Tiếp tục quá trình cài đặt với các bước dưới đây.

  1. Mở thư mục Downloads là thư mục lưu file cài đặt mà bạn tải về từ trình duyệt web bằng câu lệnh:
cd Downloads
  1. Trao quyền thực thi cho file oneclick_python_vnstock3_macos.sh để hệ thống có thể hiểu đây là file cài đặt phần mềm
chmod +x oneclick_python_vnstock3_macos.sh
  1. Chạy file cài đặt
bash ./oneclick_python_vnstock3_macos.sh
Thao tác trên Linux
  1. Mở thư mục Downloads là thư mục lưu file cài đặt mà bạn tải về từ trình duyệt web bằng câu lệnh:
cd Downloads
  1. Trao quyền thực thi cho file oneclick_python_vnstock3_macos.sh để hệ thống có thể hiểu đây là file cài đặt phần mềm
chmod +x oneclick_python_vnstock3_linux.sh
  1. Chạy file cài đặt
bash ./oneclick_python_vnstock3_linux.sh

Thành phần được cài đặt​

  1. Python phiên bản 3.10
  2. Visual Studio Code để sử dụng như một IDE (môi trường lập trình)
  3. Extension cho Visual Studio Code bao gồm Python và Jupyter để bạn có thể sẵn sàng làm việc với Vnstock3 tiện lợi nhất.
  4. Jupyterlab cho phép bạn làm việc với Vnstock3 dứới định dạng Jupyter Notebook tiện lợi theo hướng phân tích dữ liệu thay vì lập trình ứng dụng như các bạn Dev chuyên nghiệp. Khi sử dụng Visual Studio Code có cài đặt extension Jupyter, bạn có trải nghiệm sử dụng tương đương.
  5. Các gói python thiết yếu tải về từ kho phần mềm PyPI: pandas. requests, vnstock3, beautifulsoup4, selenium, openpyxl, PyYAML

Cài đặt thủ công​

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). Bạn có thể xem hướng dẫn cài đặt chi tiết tại mục hướng dẫn chi tiết cho thành viên.