# Nagare

## Bắt đầu

- [Giới thiệu Nagare](https://docs.nagare.smtdfc.net/index.md): Nagare là trợ lý AI chạy cục bộ trên máy tính của bạn, giúp tự động hóa công việc, tác vụ hệ thống và lịch nhắc.
- [Bắt đầu nhanh](https://docs.nagare.smtdfc.net/quickstart.md): 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.
- [Cài đặt](https://docs.nagare.smtdfc.net/installation.md): Cài đặt Nagare trên Linux, macOS và Windows bằng script cài đặt chính thức.

## Hướng dẫn sử dụng

- [Giao diện web](https://docs.nagare.smtdfc.net/guides/web-ui.md): Mở giao diện web, đăng nhập bằng token và quản lý các cuộc trò chuyện với Nagare.
- [Nhà cung cấp mô hình](https://docs.nagare.smtdfc.net/guides/model-providers.md): Kết nối Nagare với các API mô hình tương thích OpenAI hoặc Google, quản lý API key và chọn mô hình mặc định.
- [Công cụ tích hợp](https://docs.nagare.smtdfc.net/guides/tools.md): Danh sách công cụ Nagare dùng để thao tác với hệ thống và cơ chế phê duyệt trước khi chạy thao tác có rủi ro.
- [Cron job](https://docs.nagare.smtdfc.net/guides/cronjobs.md): Yêu cầu Nagare tự động thực hiện một việc theo lịch định kỳ.
- [Kênh Telegram](https://docs.nagare.smtdfc.net/guides/telegram.md): Trò chuyện với Nagare và phê duyệt công cụ qua bot Telegram bằng plugin tích hợp sẵn.

## Phát triển plugin

- [Tổng quan plugin](https://docs.nagare.smtdfc.net/plugins/overview.md): Cách plugin Nagare hoạt động, cấu trúc gói plugin, quyền (feature) và cách cài đặt, quản lý plugin.
- [SDK Go](https://docs.nagare.smtdfc.net/plugins/go-sdk.md): Viết plugin Nagare bằng Go: đăng ký công cụ, kênh trò chuyện và system prompt.
- [SDK Rust](https://docs.nagare.smtdfc.net/plugins/rust-sdk.md): Viết plugin Nagare bằng Rust với crate nagare_plugin.
- [Ký số plugin](https://docs.nagare.smtdfc.net/plugins/signing.md): Ký gói plugin bằng khóa Ed25519 và cấu hình khóa tin cậy để Nagare xác minh plugin khi cài đặt.

## Tham chiếu

- [Tham chiếu CLI](https://docs.nagare.smtdfc.net/reference/cli.md): Toàn bộ lệnh và tùy chọn của CLI nagare.
- [Cấu hình](https://docs.nagare.smtdfc.net/reference/configuration.md): Biến môi trường và cấu trúc thư mục dữ liệu ~/.nagare của Nagare.
- [REST API](https://docs.nagare.smtdfc.net/reference/rest-api.md): Tham chiếu REST API của Nagare gateway: phiên trò chuyện, nhà cung cấp mô hình, credential, plugin và thiết lập.
- [WebSocket](https://docs.nagare.smtdfc.net/reference/websocket.md): Nhận phản hồi trò chuyện theo thời gian thực và gửi phê duyệt công cụ qua WebSocket của Nagare gateway.
- [Khắc phục sự cố](https://docs.nagare.smtdfc.net/troubleshooting.md): Chẩn đoán và xử lý các lỗi thường gặp khi dùng Nagare.

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English (17 pages)](https://docs.nagare.smtdfc.net/_llms/en.txt): Documentation for English.


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