Môi trường ảo và thư viện

1. Kích hoạt môi trường ảo

Mỗi lần mở terminal mới, chạy trước khi dùng Vnstock. Dấu (.venv) hiện ở đầu dòng là xong.

source ~/.venv/bin/activate

Thoát môi trường: gõ deactivate.

2. Cài toàn bộ thư viện

File requirements.txt liệt kê đủ gói của hệ sinh thái Vnstock và thư viện xử lý dữ liệu đi kèm, đã trỏ sẵn kho gói riêng. Chạy sau khi kích hoạt môi trường.

Bằng pip

pip install -r https://vnstocks.com/files/requirements.txt

Bằng uv — nhanh hơn nhiều, cài một lần

pip install uv

uv pip install -r https://vnstocks.com/files/requirements.txt

Cài thêm một gói lẻ: pip install tên_gói. Xem đã có gì: pip list.

3. Tạo lại môi trường từ đầu

Khi môi trường hỏng hoặc trình cài báo lỗi lặp lại: xoá, tạo mới, kích hoạt, rồi chạy lại trình cài hoặc bước 2.

rm -rf ~/.venv

python3 -m venv ~/.venv

source ~/.venv/bin/activate

Cần Python 3.10–3.14. Máy có nhiều bản Python thì gọi đích danh, ví dụ python3.12 -m venv ~/.venv.