Cài đặt trong vài phút, phần còn lại để AI lo

1. 01

   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.

2. 02

   Dán lời nhắc vào trợ lý AI

   Lời nhắc không chứa khoá truy cập. Tên hệ điều hành đổi theo lựa chọn ở trên.

   Lời nhắcSao chép

   Hãy giúp tôi thiết lập thư viện Python vnstock thế hệ 5 (bản Cộng đồng) 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.
   - Tuyệt đối không hỏi hay yêu cầu tôi cung cấp khoá truy cập (API key) qua khung chat.
   - 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 của tôi, và các skill cấp tôi đọc đượ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.

   Thêm hướng dẫn dùng vnstock vào AGENTS.md của dự án, để trợ lý AI nhớ trong mọi phiênMặc định tắt

3. 03

   Xem và đồng ý từng lệnh

   Cài xong, trợ lý chạy thử một đoạn lấy dữ liệu để chắc là dùng được.

   Trợ lý AI · bước 3 / 5

   Môi trường ~/.venv chưa có bản vnstock cũ nào. Tôi sẽ cài Vnstock thế hệ 5 từ kho phân phối chính thức vào đó. Bạn có muốn thực hiện lệnh này không?

   $~/.venv/bin/python -m pip install -U vnstock --extra-index-url https://vnstocks.com/api/packages

   Cho phépBỏ quaTrợ lý chờ bạn trả lời

Sau khi bạn dán lời nhắc · Quy trình gồm 5 bước, trợ lý luôn hỏi ý kiến trước mỗi lệnhQuy trình 5 bước tự động

1. 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)

2. 02

   Chuẩn bị môi trường ~/.venv

   môi trường cố định; hỏi bạn trước nếu trong đó đã có bản 4.x

3. 03

   Cài đặt Vnstock thế hệ 5

   cài gói lõi tinh gọn qua pip, chỉ kèm thư viện pandas

4. 04

   Cấu hình chỉ dẫn trợ lý AI

   tuỳ chọn lưu vào tệp cấu hình để trợ lý ghi nhớ lâu dài

5. 05

   Chạy thử nghiệm truy vấn

   thực hiện truy vấn mẫu để xác nhận thư viện đã sẵn sàng

6. Kết quả đạt được

   Thư viện đã sẵn sàng để bạn bắt đầu truy vấn dữ liệu