fak — Cài đặt và bắt đầu (Bản nhập môn tiếng Việt)

Đây là một điểm vào (entry point) đã bản địa hóa, không phải bản dịch đầy đủ. Toàn bộ tài liệu là tiếng Anh — trang này đưa bạn từ một bản checkout sạch đến một kernel đang chạy, rồi dẫn tới tài liệu tiếng Anh. Lưu ý: Bản dịch này do máy tạo và đang chờ người bản ngữ soát lại — nếu phát hiện lỗi, hãy mở issue/PR. Các ngôn ngữ khác: xem i18n hub.

Đây là cửa trước để cài đặt và chạy. Phần giới thiệu chi tiết nằm ở README.

fak là một Go binary duy nhất — một artifact tĩnh, không phụ thuộc bên ngoài — nằm giữa AI agent của bạn và các tool mà nó gọi. Nó kiểm duyệt mọi tool call trước khi chạy, và tái sử dụng công việc chung lặp lại trong một phiên dài. Kết quả: cùng một agent loop trở nên an toàn, rẻ và nhanh hơn, mà không phải viết lại gì. Bạn không viết lại agent — bạn chỉ trỏ một base URL về fak serve, hoặc bọc agent hiện có bằng một lệnh:

fak guard -- claude

Vì sao điều này quan trọng ở Việt Nam

Về prompt-cache của provider. Chiết khấu prompt-cache chỉ còn hiệu lực khi cached prefix giữ nguyên từng byte; fak vẫn giữ prefix byte-identical trong khi loại bỏ các lượt cũ ở giữa. fak bảo đảm tính byte-identical của prefix; còn việc provider có thật sự tái dùng cache hay không là quyết định của provider — fak chuyển tiếp (relay) điều đó chứ không tự tuyên bố.

0. Điều kiện tiên quyết

Các tier (theo chi phí thiết lập tăng dần)

Tier Bạn nhận được Thiết lập
0 — Thử kernel Chạy/đo ranh giới kiểm duyệt (adjudication) offline go build
1 — Đặt trước một model thật Đặt kernel trước một model bạn phục vụ ở nơi khác (Ollama / vLLM / llama.cpp / cloud) + một OpenAI-compatible server đang chạy
1b — Model local bằng một lệnh Chạy một model GGUF local in-kernel với agent hiện có — không key, không mạng, không cần terminal thứ hai fak guard --gguf qwen2.5:7b -- claude
2 — Model hợp nhất trong kernel Forward pass thuần Go do kernel sở hữu (proven bit-exact) + export (real weights)

Nếu bạn chỉ muốn phục vụ một model hữu ích với fak đứng trước nó, hãy chọn Tier 1. Model in-kernel ở Tier 2 là một reference forward pass được chứng minh khớp từng bit với HuggingFace, không phải một serving engine chất lượng chat.

Cài đặt binary

Build từ bản clone:

go build -o fak ./cmd/fak

Hoặc cài trực tiếp bằng Go (module path chính là gốc repository):

go install github.com/anthony-chaudhary/fak/cmd/fak@latest

Ghi chú cho Windows. Trên Windows hãy build bằng go build -o fak.exe ./cmd/fak; -o fak (không đuôi) để lại một file fak mà cmd.exe / PowerShell không gọi được theo tên. go build / go vet / go run chạy natively; nếu cần chạy go test ./..., hãy chạy dưới WSL.

Bằng chứng 60 giây (không key, không model, không GPU)

go build -o fak ./cmd/fak
./fak preflight --policy examples/customer-support-readonly-policy.json --tool refund_payment --args "{}"   # -> DENY (POLICY_BLOCK)
./fak preflight --policy examples/customer-support-readonly-policy.json --tool search_kb     --args "{}"   # -> ALLOW
./fak agent --offline                                                                                       # injection blocked, task still completes

Vì sao điều này an toàn theo cấu trúc, không phải nhờ một classifier:

Chạy với model của bạn

fak govern và cache model của bạn; nó không thay thế model. Qwen2/Qwen3 và GLM-MoE đã được chứng minh bit-exact trong reference engine in-kernel. Mọi thứ khác (DeepSeek, Mistral, bất kỳ open-weights model nào) đứng phía trước qua OpenAI-compatible wire: Ollama / vLLM / SGLang / llama.cpp / LM Studio hoặc bất kỳ OpenAI-compatible API nào.

Đi tiếp đâu

License: Apache-2.0.