From 915f844d3d70a04a5a56ff359e1c663494aaf089 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tr=E1=BB=8Bnh=20Duy=20H=C6=B0ng?=
<57101685+HUNG-rushb@users.noreply.github.com>
Date: Tue, 10 Sep 2024 21:51:06 +0700
Subject: [PATCH] [docs]: Update Vietnamese translation
---
README.md | 2 +-
docs/README_VN.md | 160 ++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 161 insertions(+), 1 deletion(-)
create mode 100644 docs/README_VN.md
diff --git a/README.md b/README.md
index 291bc82..513d6ce 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@
- [中文版](docs/README_CN.md) | [日本語](docs/README_JA.md) | [English](README.md)
+ [中文版](docs/README_CN.md) | [日本語](docs/README_JA.md) | [English](README.md) | [Tiếng Việt](README_VN.md)
diff --git a/docs/README_VN.md b/docs/README_VN.md
new file mode 100644
index 0000000..0b8c089
--- /dev/null
+++ b/docs/README_VN.md
@@ -0,0 +1,160 @@
+○
+
+
+ 
+
+
+ Giao diện giọng nói (voice interface) mã nguồn mở số #1.
+
Cập nhật mới nhất | Tài liệu
+
+
+
+
+
+
+Chúng tôi muốn hỗ trợ bạn phát triển ứng dụng. [Đăng ký hỗ trợ 1-1.](https://0ggfznkwh4j.typeform.com/to/kkStE8WF)
+
+
+
+> [!QUAN TRỌNG]
+> Dự án thử nghiệm này đang được phát triển khá nhanh và đang thiếu các bảo vệ cơ bản. Cho đến khi có bản phát hành `1.0` ổn định, bạn chỉ nên chạy repo này trên các thiết bị không có thông tin nhạy cảm hoặc quyền truy cập vào các dịch vụ phải trả phí.
+
+
+
+**01** là nền tảng nguồn mở dành cho các thiết bị đàm thoại, lấy cảm hứng từ máy tính *Rabbit R1* và *Star Trek*.
+
+Bằng cách xây dựng project này xoay quanh [Open Interpreter](https://github.com/OpenInterpreter/open-interpreter), **01** giờ đây tự nhiên, linh hoạt và sở hữu nhiều tiềm năng hơn nền tảng tiền nhiệm. Các trợ lý ảo được xây dựng từ repo này có thể:
+
+- Thực thi code
+- Duyệt web
+- Đọc và tạo file
+- Điều khiển các ứng dụng của bên thứ 3
+- ...
+
+
+
+Chúng tôi muốn trở thành một GNU/Linux của lĩnh vực mới này bằng cách duy trì mã nguồn mở theo hướng module và miễn phí như cách họ đã làm.
+
+
+
+# Đối với phần mềm
+
+```shell
+git clone https://github.com/OpenInterpreter/01
+cd 01/software
+```
+
+> Không cài đặt được? Hãy xem qua [hướng dẫn setup](https://01.openinterpreter.com/software/introduction).
+
+```shell
+brew install ffmpeg # Chỉ dành cho Mac. Cho Windows và Linux, hãy xem bên dưới.
+poetry install
+poetry run 01
+```
+
+
+
+
+
+**Lưu ý:** Thư viện [RealtimeSTT](https://github.com/KoljaB/RealtimeSTT) và [RealtimeTTS](https://github.com/KoljaB/RealtimeTTS) là trái tim của 01, đồng thời là thành quả của [Kolja Beigel](https://github.com/KoljaB). Xin hãy tiếp tục đóng góp cho các repo đó và đừng quên tặng sao!
+
+# Đối với phần cứng
+
+**01** cũng là hub cho các thiết bị phần cứng chạy và kết nối tới phần mềm của chúng ta.
+
+- Mac, Windows, và Linux đã được hỗ trợ, hãy chạy `poetry run 01`. [Server 01](https://01.openinterpreter.com/software/run) và client sử dụng nút `ctrl` để mô phỏng 01 Light.
+- Ứng dụng Android và iOS đang trong quá trình phát triển [here](software/source/clients/mobile).
+- 01 Light dựa trên ESP32, và là một giao diện nhấn-để-nói (push-to-talk interface). Tài liệu [ở đây.](https://01.openinterpreter.com/hardware/01-light/materials)
+ - Hoạt động bằng cách kết nối với [Server 01](https://01.openinterpreter.com/software/run).
+
+
+
+**Chúng tôi cần sự giúp đỡ của bạn để hỗ trợ và xây dựng thêm phần cứng.** 01 sẽ có thể chạy trên mọi thiết bị có đầu vào (micrô, bàn phím, v.v.), đầu ra (loa, màn hình, motor, v.v.) và với kết nối internet (hoặc tính toán đủ để chạy mọi thứ local). [Hướng dẫn đóng góp ↗️](https://github.com/OpenInterpreter/01/blob/main/CONTRIBUTING.md)
+
+
+
+# Cách thức hoạt động
+
+01 mở port websocket chuyển lời nói thành giọng nói (speech-to-speech) tại `localhost:10101`.
+
+Nếu bạn truyền byte âm thanh thô (raw audio bytes) tới `/` trong [Streaming với định dạng LMC](https://docs.openinterpreter.com/guides/streaming-response), bạn sẽ nhận được phản hồi của nó ở cùng định dạng.
+
+Dựa trên ý tưởng [Hệ điều hành LLM của Andrej Karpathy](https://twitter.com/karpathy/status/1723140519554105733), chúng ta chạy [mô hình ngôn ngữ thông dịch code (code-interpreting language model)](https://github.com/OpenInterpreter/open-interpreter), và gọi nó khi một event cụ thể xảy ra trên [kernel](https://github.com/OpenInterpreter/01/blob/main/software/source/server/utils/kernel.py) máy tính của bạn.
+
+01 gói gọn nó trong một giao diện giọng nói (voice interface):
+
+
+
+
+
+# Các giao thức (Protocols)
+
+## Thông báo LMC (LMC Messages)
+
+Để giao tiếp với các thành phần khác nhau của hệ thống này, chúng tôi xin giới thiệu định dạng [Thông báo LMC (LMC Messages)](https://docs.openinterpreter.com/protocols/lmc-messages), thêm vào định dạng tin nhắn của OpenAI vai trò "computer":
+
+https://github.com/OpenInterpreter/01/assets/63927363/8621b075-e052-46ba-8d2e-d64b9f2a5da9
+
+## Thông báo hệ thống động (Dynamic System Messages)
+
+Thông báo hệ thống động (Dynamic System Messages) cho phép bạn thực thi code bên trong thông báo hệ thống của LLM, ngay trước khi nó được xử lý với AI.
+
+```python
+# Chỉnh sửa các cài đặt dưới trong Profiles
+interpreter.system_message = r" The time is {{time.time()}}. " # Mọi thứ trong ngoặc kép sẽ được thực thi dưới dạng Python
+interpreter.chat("What time is it?") # Nó sẽ biết mà không cần gọi tool/API
+```
+
+# Hướng dẫn
+
+## Server 01
+
+Để chạy server trên Desktop và kết nối với 01 Light của bạn, chạy các lệnh sau:
+
+```shell
+brew install ngrok/ngrok/ngrok
+ngrok authtoken ... # Sử dụng ngrok authtoken của bạn
+poetry run 01 --server light --expose
+```
+
+Lệnh cuối cùng sẽ in URL máy chủ. Bạn có thể nhập thông tin này vào portal WiFi cố định của 01 Light để kết nối với Server 01 của bạn.
+
+## Chạy trên Local
+
+```
+poetry run 01 --profile local.py
+```
+
+## Tùy chỉnh
+
+Để tùy chỉnh hoạt động của hệ thống, hãy chỉnh sửa [system message, model, skills library path,](https://docs.openinterpreter.com/settings/all-settings), v.v. trong folder `profiles` bên trong folder `server`. File này thiết lập một trình thông dịch (interpreter) và được hỗ trợ bởi Open Interpreter.
+
+Để chỉ định dịch vụ chuyển văn bản thành giọng nói (text-to-speech) cho 01 `base_device.py`, hãy chỉnh sửa `interpreter.tts` thành "openai" cho OpenAI, "elevenlabs" cho ElevenLabs hoặc "coqui" cho Coqui (local) trong profile. Đối với 01 Light, chỉnh sửa `SPEAKER_SAMPLE_RATE` trong `client.ino` trong thư mục máy khách (client directory) `esp32` thành 24000 cho Coqui (cục bộ) hoặc 22050 cho OpenAI TTS. Hiện tại chúng tôi không hỗ trợ ElevenLabs TTS trên 01 Light.
+
+## Package cần cài đặt (Ubuntu Dependencies)
+
+```bash
+sudo apt-get install ffmpeg
+```
+
+# Đóng góp
+
+[](https://github.com/OpenInterpreter/01/graphs/contributors)
+
+Xin hãy xem qua [hướng dẫn đóng góp](CONTRIBUTING.md) để biết thêm chi tiết và cách tham gia.
+
+
+
+## Directory
+
+### [Context ↗](https://github.com/KillianLucas/01/blob/main/CONTEXT.md)
+
+Tiêu chuẩn của 01.
+
+### [Roadmap ↗](/ROADMAP.md)
+
+Kế hoạch tương lai của 01.
+
+
+
+○