> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nagare.smtdfc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Bắt đầu nhanh

> Cài đặt Nagare, khởi động gateway, thêm nhà cung cấp mô hình và gửi tin nhắn đầu tiên.

Hướng dẫn này đưa bạn từ lúc cài đặt đến khi trò chuyện được với Nagare.

**1. Cài đặt Nagare**

> [tab] Linux / macOS
>
> ```bash theme={null}
> curl -fsSL https://raw.githubusercontent.com/smtdfc/nagare/main/installers/linux/install.sh | sudo bash
> ```

> [tab] Windows (PowerShell)
>
> ```powershell theme={null}
> irm https://raw.githubusercontent.com/smtdfc/nagare/main/installers/window/install.ps1 | iex
> ```

Đảm bảo thư mục `$HOME/.local/bin` nằm trong biến `PATH`, rồi kiểm tra:

```bash theme={null}
nagare --version
```

Xem chi tiết tại [Cài đặt](https://docs.nagare.smtdfc.net/installation.md).

**2. Khởi động gateway**

```bash theme={null}
nagare gateway start
```

Gateway chạy ở tiền cảnh của cửa sổ terminal hiện tại và lắng nghe tại `localhost:9832`. Giữ cửa sổ này mở và dùng một terminal khác cho các bước tiếp theo.

> [!NOTE]
>
> Lần chạy đầu tiên, Nagare tự tạo cặp khóa RSA 4096-bit và lưu vào keyring của hệ điều hành. Khóa này dùng để ký và xác minh token đăng nhập.

**3. Mở giao diện web**

```bash theme={null}
nagare web
```

Lệnh này tự tạo token đăng nhập và mở trình duyệt tại `http://127.0.0.1:3005`. Bạn được đăng nhập tự động.

**4. Thêm nhà cung cấp mô hình**

Vào **Settings → Model providers** và thêm một nhà cung cấp tương thích **OpenAI** hoặc **Google**, nhập API key và chọn mô hình. Xem [Nhà cung cấp mô hình](https://docs.nagare.smtdfc.net/guides/model-providers.md).

**5. Chọn mô hình mặc định**

Vào **Settings → General**, chọn **Default model** (nhà cung cấp và mô hình dùng cho các cuộc trò chuyện mới).

**6. Bắt đầu trò chuyện**

Tạo một cuộc trò chuyện mới và thử:

```text theme={null}
Mấy giờ rồi? Liệt kê 5 tiến trình đang dùng nhiều RAM nhất.
```

Nagare sẽ tự tìm và gọi các công cụ phù hợp. Với thao tác có rủi ro (xóa tệp, tắt máy...), bạn sẽ được hỏi để phê duyệt trước.

## Kiểm tra hệ thống

Nếu có lỗi, chạy:

```bash theme={null}
nagare doctor
```

Xem thêm tại [Khắc phục sự cố](https://docs.nagare.smtdfc.net/troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.