Hướng dẫn người tài trợ
Cài bộ thư viện mở rộng chỉ trong vài phút
Với Vnstock thế hệ 5, quy trình được tối giản hoá: lưu khoá bảo mật một lần trên máy, gửi lời nhắc cho trợ lý AI và toàn bộ thư viện mở rộng theo cấp tài trợ sẽ được tự động cài đặt qua lệnh `vnstock install`.
01 · Cài đặt
Một lệnh lưu khoá, một lời nhắc
Khoá truy cập được bảo mật ngay trên máy tính của bạn và không bao giờ xuất hiện trong khung chat với trợ lý AI, giúp đảm bảo an toàn tuyệt đối.
Hướng dẫn này cài vnstock thế hệ 5. Bạn đang chạy vnstock 4.x hoặc vnstock_data 3.x và chưa muốn chuyển? Cài bản cũ.
01
Lưu khoá truy cập vào máy
Đang tải khoá truy cập của bạn…
02
Mở trợ lý AI bạn đang dùng
Trên máy tính, bản ứng dụng hay trợ lý dòng lệnh đều được.
Ứng dụng trò chuyện
- Claude
- ChatGPT
- Antigravity
Chạy lệnh trên máy
- Claude Code
- Codex
- VS Code
- Antigravity IDE
Các trợ lý lập trình chuyên dụng (như Claude Code, Antigravity) có thể tự động cài đặt thay bạn. Với ứng dụng trò chuyện thông thường, trợ lý sẽ cung cấp từng lệnh chuẩn xác để bạn thực thi.
03
Dán lời nhắc vào trợ lý AI
Trợ lý cho bạn xem từng lệnh và chờ bạn đồng ý rồi mới chạy.
Lời nhắcHãy giúp tôi thiết lập thư viện Python vnstock thế hệ 5 cùng các gói mở rộng theo cấp tài trợ của tôi trên máy macOS, tuân thủ tài liệu hướng dẫn tại https://vnstocks.com/files/vibe-onboarding.md - Trước khi thực hiện bất kỳ lệnh nào, hãy giải thích rõ và chờ tôi xác nhận đồng ý. - Cài vào môi trường ảo cố định ~/.venv (tạo mới nếu chưa có), trừ khi tôi yêu cầu chỗ khác; trên Google Colab hay GitHub Codespaces thì cài thẳng vào môi trường của phiên, không tạo môi trường ảo. - Trước khi cài, kiểm tra môi trường đó đang có gì. Nếu đã có vnstock 4.x, vnstock_data hoặc vnai, hãy dừng lại và hỏi tôi: cài đè sẽ làm hỏng bản cũ và không khôi phục được. Khi đó hãy đề xuất cài thế hệ 5 vào ~/.venv5x. - Khoá truy cập đã được tôi lưu sẵn trên máy an toàn. Bạn tuyệt đối không tìm cách đọc, in hay yêu cầu tôi gửi khoá qua khung chat. Sau khi cài đặt, hãy kiểm tra trạng thái bằng lệnh `vnstock status`; nếu cần đăng nhập lại hãy hướng dẫn tôi tự chạy `vnstock register`. Sau đó cài đặt các gói mở rộng được phép bằng lệnh `vnstock install`. - Cài xong, chạy `vnstock onboard` bằng lệnh vnstock của môi trường đó và làm theo hướng dẫn nó in ra trước khi viết mã: quy tắc, bước tiếp theo theo cấp tài trợ của tôi, và các skill cấp tôi đọc được. Với mỗi việc tôi giao, đọc skill phù hợp cùng tệp tham chiếu của nó trước. Nếu lệnh báo không có `onboard`, chạy `vnstock update` rồi thử lại. - Không tự ý ghi đè hay thay đổi các tệp cấu hình trợ lý AI (AGENTS.md, CLAUDE.md...) nếu chưa có yêu cầu. - Khi hoàn tất cài đặt, hãy chạy một truy vấn mẫu lấy thông tin hợp đồng tương lai VN30F1M để kiểm tra tính sẵn sàng, đồng thời gợi ý cho tôi 3 bài toán nghiên cứu đầu tiên để bắt đầu trải nghiệm ngay.
Sau khi bạn dán lời nhắc · Quy trình gồm 6 bước, trợ lý luôn hỏi ý kiến trước mỗi lệnhQuy trình 6 bước tự động
- 01
Nhận diện hệ thống và Python
tự động kiểm tra phiên bản (yêu cầu từ Python 3.10)
- 02
Cài đặt Vnstock thế hệ 5
cài đặt nhanh qua pip, không cần phần mềm cài đặt rời
- 03
Xác thực cấp quyền tài trợ
kiểm tra trạng thái bằng vnstock status, bảo mật tuyệt đối khoá
- 04
Cài đặt thư viện mở rộng
tự động cài các gói phân quyền tương ứng qua vnstock install
- 05
Cấu hình chỉ dẫn trợ lý AI
ghi nhớ quy tắc vào tệp cấu hình dự án (mặc định tắt)
- 06
Chạy thử nghiệm & chẩn đoán
chạy truy vấn thực tế hoặc dùng vnstock doctor nếu cần
Kết quả đạt được
Toàn bộ thư viện mở rộng theo cấp tài trợ đã sẵn sàng
Nếu gặp sự cố trong quá trình cài đặt, lệnh `vnstock doctor` sẽ giúp bạn chẩn đoán ngay nguyên nhân, hoặc bạn có thể chuyển sang chế độ cài thủ công.
Cách cài bằng tay02 · Sau khi cài
Thư viện hợp nhất từ Thế hệ 5
Kể từ thế hệ 5 (phát hành chính thức 15/10/2026), Vnstock hợp nhất thành một thư viện duy nhất cho mọi cấp độ người dùng. Hệ thống tự động nhận diện tính năng qua khoá truy cập, giúp bạn nâng cấp gói tài trợ mà không cần sửa lại mã nguồn hay đổi dòng lệnh import.
Mã đang viết cho vnstock_data 3.x? Hướng dẫn chuyển đổi liệt kê từng dòng import và tên hàm cần đổi.
-from vnstock_data import Market # bản tài trợ cũ (cú pháp thế hệ cũ)+from vnstock import Market # thế hệ 5, mọi cấp (cú pháp thế hệ 5)# Cấp lấy từ khoá đã đăng nhập (vnstock register)df = Market().equity("FPT").ohlcv()
03 · Tra cứu tài liệu
Đổi bản mới và cũ trên trang tài liệu
Toàn bộ tài liệu thư viện trên vnstocks.com tích hợp sẵn bộ chọn phiên bản ngay ở đầu trang. Bạn có thể xem lại tài liệu các thế hệ trước (như Vnstock TA, vnstock_data 3.x) hoặc chuyển sang bản mới nhất mà không mất ngữ cảnh.
- Dấu hiệu nhận biết: Trang bản cũ có nhãn Bản cũ kèm dải thông báo màu hổ phách.
- Chuyển trang thông minh: Tự động tìm bài tương ứng ở bản kia thay vì đưa bạn về trang chủ.
- Thanh bên đồng bộ: Mục lục bên trái tự động hiển thị đúng các hàm của phiên bản đang xem.
Vnstock Quant (v0.1.3)
Tính toán định lượng chuyên sâu (TA, FA, Risk, Portfolio) với lõi Rust hiệu năng cao.
vnstock_quant.Interactive Mockup04 · Hướng dẫn
Đi tiếp từ đây
Hướng dẫn cài đặt, vận hành trọn bộ bốn thư viện thế hệ 5 và các tài liệu tham khảo chi tiết dành riêng cho người tài trợ.
Cài đặt và vận hành
6 trang- Thế hệ 5
Cài đặt & gỡ lỗi
Cài vnstock thế hệ 5, đăng nhập bằng khoá và tra lỗi theo đúng dòng bạn thấy.
- Chuyển đổi
Từ vnstock_data 3.x sang thế hệ 5
Đổi dòng import, tên hàm và cách đăng nhập; giữ bản cũ làm đường lui.
- Thành viên
Chỉ dẫn trợ lý AI (Agent Guide)
Một đoạn lời nhắc; hệ thống tự nhận cấp tài trợ để nạp đúng bộ chỉ dẫn.
- Thành viên
Kho kỹ năng (Skills Hub)
Kỹ năng cho trợ lý AI dùng đúng bộ công cụ theo cấp của bạn.
- Thành viên
Bộ khung vận hành (Harness Engineering)
Bộ khung vận hành AI phân tích có căn cứ và kiểm chứng số liệu.
- Bản cũ
Vẫn dùng bản 4.x
Trình cài giao diện, trình cài dòng lệnh và môi trường ảo cho vnstock_data 3.x.
Bốn thư viện thế hệ 5
4 trang- Mọi cấp
Thư viện chính
vnstock
Dữ liệu thị trường, báo cáo tài chính, vĩ mô. Khoá quyết định hàm nào chạy được.
- Dùng thử từ Cộng đồng
Định lượng
vnstock_quant
Chỉ báo kỹ thuật, chỉ số tài chính, rủi ro và danh mục. Bronze mở phần nâng cao, Silver mở đủ chỉ báo.
- Từ Silver
Tin tức
vnstock_news
Đọc tiêu đề, thời gian và đường dẫn bài từ các trang tin đã cấu hình, để bạn đọc bài tại trang gốc.
- Từ Golden
Quy trình dữ liệu
vnstock_pipeline
Quản lý thư mục dữ liệu trên máy, tải theo lô, xuất sang định dạng phần mềm phân tích.
Đọc thêm khi cần
4 trang05 · Video
Xem thay vì đọc
Xem video minh hoạ toàn bộ quá trình trợ lý AI tự động thiết lập môi trường và cài đặt.
Bộ hướng dẫn đầy đủ
Chinh phục Vibe Coding cùng Vnstock
Đi từ dựng môi trường tới viết chương trình truy vấn hoàn chỉnh cùng trợ lý AI.
Xem chi tiết khoá họcNgười mới học code?
Khái niệm nền, cài Python, chạy lệnh đầu tiên, để trợ lý AI viết chương trình.
06 · Hỏi đáp
Câu hỏi thường gặp
Những câu hỏi thường gặp nhất trong quá trình kích hoạt và cài đặt bộ thư viện mở rộng.
Chưa thấy câu của bạn?
Hỏi trong nhóm SponsorKhoá truy cập (API key) là gì? Khoá có an toàn không?
vnstock register trên từng thiết bị.Tôi gặp lỗi trong quá trình cài đặt, phải xử lý thế nào?
vnstock doctor: tiện ích này tự kiểm tra 7 hạng mục (kết nối mạng, trạng thái khoá, hạn mức sử dụng, phiên bản thư viện...) và hướng dẫn cách khắc phục cụ thể nếu phát hiện lỗi. Trường hợp lệnh vnstock chưa thể kích hoạt, bạn hãy kiểm tra phiên bản Python trên máy đạt từ 3.10 trở lên và tham khảo trang hướng dẫn cài đặt & gỡ lỗi, hoặc nhắn tin vào nhóm hỗ trợ Sponsor.Vnstock được cài vào môi trường nào?
~/.venv trên macOS và Linux, $HOME\.venv trên Windows. Thư viện chạy được ở môi trường khác, nhưng một chỗ cố định giúp bạn, nhóm hỗ trợ và trợ lý AI luôn biết Python đầy đủ cho vnstock nằm ở đâu khi cần kiểm tra. Bạn muốn cài chỗ khác thì chỉ cần nói với trợ lý. Nếu ~/.venv đang có bản 4.x (vnstock_data, vnai), trợ lý sẽ hỏi bạn trước, vì cài đè sẽ làm hỏng bản cũ và không lấy lại được; khi đó thế hệ 5 vào ~/.venv5x. Trên Google Colab hay GitHub Codespaces thì cài thẳng vào môi trường của phiên, không tạo môi trường ảo.Cần làm gì khi hệ thống báo vượt quá số lượng thiết bị cho phép?
vnstock register trên máy tính mới để kích hoạt quyền sử dụng.Làm thế nào để cập nhật khi thư viện có phiên bản mới?
-U, sau đó thực thi vnstock install -U để cập nhật toàn bộ thư viện mở rộng. Lệnh vnstock version sẽ cho bạn biết chi tiết phiên bản đang cài đặt và phiên bản mới nhất trên máy chủ. Đối với người dùng duy trì bản 4.x, xin vui lòng xem hướng dẫn tại trang hướng dẫn bản cũ.Tôi đang dùng vnstock_data 3.x, có bắt buộc phải chuyển sang thế hệ 5 ngay không?
~/.venv5x nếu ~/.venv đang chứa bản cũ, để bản cũ vẫn chạy và bạn quay lại được bất kỳ lúc nào, sau đó tham khảo hướng dẫn chuyển đổi chi tiết để cập nhật tên hàm và cú pháp gọi dữ liệu.