# Agent GPU cộng đồng — hoclieu.org

Agent chạy trên máy bạn, **chỉ gọi RA ngoài** tới máy chủ hoclieu.org (không mở bất kỳ cổng nào). Nó nhận việc sinh học liệu công khai, chạy bằng LLM tại máy (vLLM/Ollama) rồi gửi kết quả về.


## Cài nhanh một dòng lệnh (khuyến nghị)

Trên máy GPU (Linux) đã chạy sẵn vLLM (cổng 8000) hoặc Ollama (cổng 11434), dán lệnh hiện trong **Hồ sơ → Đóng góp GPU cho cộng đồng**:

```bash
curl -fsSL https://hoclieu.org/gpu-agent/install.sh | bash -s -- --key hlk_xxxxxxxx
```

Script sẽ: kiểm tra Python và GPU, tự tìm API mô hình, tải agent và kiểm tra mã băm SHA-256, lưu cấu hình vào `~/.config/hoclieu-agent/env` (chỉ chủ tài khoản đọc được), chạy thử một lần, rồi cài dịch vụ chạy nền `systemctl --user` (không cần root).

- Chỉ định API khác: thêm `--llm http://dia-chi:cong/v1 --model ten-model`
- Xem trạng thái: `systemctl --user status hoclieu-agent` · nhật ký: `journalctl --user -u hoclieu-agent -f`
- Gỡ cài đặt: `curl -fsSL https://hoclieu.org/gpu-agent/install.sh | bash -s -- --uninstall`

## Yêu cầu
- GPU NVIDIA, **≥ 16 GB VRAM** (khuyến nghị).
- Python 3.9+ (chỉ dùng thư viện chuẩn).
- Chạy sẵn một LLM có **API OpenAI-compatible** tại máy, ví dụ **vLLM** hoặc **Ollama** (mặc định `http://127.0.0.1:8000/v1`).
- `nvidia-smi` có trong PATH (nếu không, agent vẫn chạy nhưng báo GPU rỗng).

## Lấy key
Đăng nhập hoclieu.org → **Hồ sơ → Đóng góp GPU** → tạo key (dạng `hlk_...`).

## Chạy
```bash
export HL_KEY=hlk_xxxxxxxx
python3 hoclieu_agent.py