Proxyma Desktop trên Linux

Những gì khác biệt khi chạy Proxyma Desktop trên Linux.

Hãy đọc tài liệu hướng dẫn bản desktop cho mọi thứ còn lại

Nhà cung cấp AI, thêm tài liệu, đặt câu hỏi, cấp phép và xử lý sự cố chung được trình bày trong tài liệu hướng dẫn Proxyma Desktop.

Cài đặt

Proxyma cho Linux là một gói .deb nhỏ dành cho Ubuntu và Debian. Gói chứa trình khởi chạy, môi trường chạy Java và cửa sổ ứng dụng. Phần còn lại Proxyma sẽ tải về trong lần khởi động đầu tiên.

Từ kho phần mềm Proxyma (khuyến nghị)

apt kiểm tra mọi tệp tải về từ kho này bằng khóa ký của Proxyma.

sudo install -d -m 0755 /etc/apt/keyrings
sudo wget -qO /etc/apt/keyrings/proxyma.asc https://proxyma.ai/keys/proxyma-release.asc
echo "deb [signed-by=/etc/apt/keyrings/proxyma.asc] https://github.com/proxyma-ai/proxyma-releases/releases/download/apt/ ./" | sudo tee /etc/apt/sources.list.d/proxyma.list
sudo apt update && sudo apt install proxyma

Dấu vân tay của khóa là BE3A B092 AB25 4FA4 5C57 8AF4 F571 F889 94F6 B817. Proxyma vẫn tự cập nhật; sudo apt upgrade giữ cho gói cài đặt luôn mới.

Từ tệp đã tải về

sudo apt install ./proxyma_<version>_amd64.deb

Giữ nguyên ./, nếu không apt sẽ tìm trong các kho phần mềm thay vì cài chính tệp tin đó. Proxyma xuất hiện trong trình đơn ứng dụng; sudo apt remove proxyma sẽ gỡ nó.

Lần khởi động đầu tiên tải về phần còn lại của Proxyma

Kết nối internet. Lần khởi động đầu tiên cần mạng; các lần sau thì không.
Khởi động Proxyma. Nó tải về phần còn lại của ứng dụng, khoảng vài trăm megabyte, và hiển thị tiến trình tải.
Sau đó nó thiết lập môi trường Python, mất khoảng một phút.

Nếu việc tải về bị gián đoạn, hãy khởi động lại Proxyma. Nó sẽ tải tiếp từ chỗ đã dừng. Mọi tệp đều được đối chiếu với mã kiểm tra đã ký của bản phát hành trước khi được cài đặt.

Nếu mạng công ty dùng proxy, Proxyma dùng thiết lập proxy của hệ thống hoặc biến HTTPS_PROXY, cùng các tổ chức cấp chứng chỉ mà hệ thống của bạn tin cậy.

Yêu cầu hệ thống

Thành phần	Yêu cầu
Hệ điều hành	Ubuntu hoặc Debian, 64-bit (x86-64)
Phiên làm việc đồ họa	X11 hoặc Wayland. Không phải dịch vụ chạy nền không màn hình - hãy dùng Proxyma Home Server cho việc đó.
Bộ nhớ	8 GB, hoặc 16 GB nếu bạn chạy một mô hình AI nội bộ trên cùng chiếc máy
Dung lượng đĩa	3 GB cho ứng dụng và môi trường chạy của nó, cộng thêm chỗ cho chỉ mục của bạn
Kết nối internet	Cần cho lần khởi động đầu tiên, việc kích hoạt và kiểm tra lại bản quyền, cập nhật, các nguồn dữ liệu trên máy chủ khác, và cho một nhà cung cấp AI trực tuyến nếu bạn chọn dùng

Khởi động Proxyma

Hãy khởi động nó từ trình đơn ứng dụng. Proxyma mở ra trong cửa sổ ứng dụng riêng của nó. Khởi động lại khi nó đang chạy sẽ đưa cửa sổ đó trở lại.

Khởi động từ cửa sổ dòng lệnh? Đóng nó lại là Proxyma dừng

Chạy proxyma trong cửa sổ dòng lệnh sẽ hiện các thông báo khởi động, giúp chẩn đoán lỗi khởi động. Đóng cửa sổ dòng lệnh đó hoặc nhấn Ctrl+C sẽ dừng Proxyma.

Nội dung in ra là nhật ký khởi động thông thường, không phải lỗi. Nó cũng được ghi vào ~/.local/share/proxyma/logs/proxyma.log.

Thoát ứng dụng

Mở menu ở góc trên bên phải cửa sổ Proxyma rồi chọn Thoát Proxyma, sau đó chọn Thoát. Thao tác này dừng ứng dụng cùng các tiến trình nền, bất kể bạn đã khởi động bằng cách nào.

Đóng cửa sổ không làm Proxyma dừng lại. Hãy khởi động lại từ trình đơn, hoặc truy cập http://localhost:4246, để mở nó.

Vì sao có thể không có biểu tượng ở khay hệ thống

Proxyma hiển thị biểu tượng khay hệ thống ở những môi trường desktop có hỗ trợ. GNOME không có phần mở rộng và phiên Wayland thuần túy thì không hỗ trợ. Mục Thoát Proxyma trong menu của ứng dụng lúc nào cũng hoạt động.

Cập nhật

Proxyma tự kiểm tra và cài đặt phiên bản mới. Hãy vào Cài đặt → Cập nhật để xem phiên bản hiện tại, kiểm tra ngay, hoặc tắt tự động kiểm tra. Bản cập nhật không động tới chỉ mục, các cuộc trò chuyện hay các thiết lập của bạn.

Khi có phiên bản mới, Proxyma chỉ tải về những phần đã thay đổi. Phần nào không khớp với mã kiểm tra đã ký của bản phát hành sẽ bị từ chối.
Chọn Khởi động lại và cài đặt vào lúc thuận tiện. Không cần nhập mật khẩu.

Nếu phiên bản mới không khởi động được, Proxyma tự quay về phiên bản trước.

Dữ liệu của bạn nằm ở đâu

Thứ gì	Nằm ở đâu
Chỉ mục, các cuộc trò chuyện, các thiết lập	`~/.local/share/proxyma/` (hoặc `$XDG_DATA_HOME/proxyma/` nếu bạn có đặt biến này)
Các phần ứng dụng đã tải về	`~/.local/share/proxyma/parts/` - được tải về trong lần chạy đầu tiên và khi cập nhật
Môi trường chạy Python	`~/.local/share/proxyma/runtime/` - được thiết lập trong lần chạy đầu tiên
Nhật ký	`~/.local/share/proxyma/logs/`
Kỹ năng và tệp của các cuộc trò chuyện	`~/.proxyma/`
Thông tin đăng nhập	Được mã hóa trong thư mục dữ liệu, với khóa nằm trong một tệp ở đó - xem bên dưới.
Tài liệu của bạn	Vẫn ở nguyên chỗ cũ - Proxyma không sao chép và không di chuyển chúng

Hãy sao lưu ~/.local/share/proxyma/ để giữ chỉ mục và lịch sử trò chuyện. Mất nó thì bạn phải lập chỉ mục lại, và thông tin đăng nhập đã lưu cùng bản quyền đã kích hoạt không còn đọc được. Tài liệu của bạn không bị mất.

Để gỡ bỏ Proxyma hoàn toàn:

Chạy sudo apt remove proxyma. Lệnh này gỡ gói cài đặt, nhưng không xóa những gì Proxyma đã tải về ~/.local/share/proxyma/.
Xóa ~/.local/share/proxyma/ và ~/.proxyma/. Thao tác này cũng xóa chỉ mục, các cuộc trò chuyện và các thiết lập của bạn.

Để giải phóng dung lượng mà vẫn giữ dữ liệu, chỉ xóa parts/ và runtime/ trong ~/.local/share/proxyma/.

Thông tin đăng nhập của các bộ kết nối được giữ ở đâu

Mật khẩu và mã thông báo (token) của các bộ kết nối được mã hóa bằng một khóa nằm trong tệp .secret ở thư mục dữ liệu, chỉ tài khoản của bạn đọc được (0600).

Tài liệu quét và OCR

Tệp PDF được quét cần OCR. Hãy chọn một mô hình OCR trong Cài đặt → Chuyển đổi, hoặc chọn bộ máy Tesseract ở đó. Gói cài đặt tự cài Tesseract kèm tiếng Anh và tiếng Việt; nếu hệ thống của bạn bỏ qua các gói được đề xuất, hãy chạy sudo apt install tesseract-ocr tesseract-ocr-eng tesseract-ocr-vie. Tệp PDF có lớp văn bản, tài liệu Office, Markdown, văn bản thuần và HTML đều dùng được mà không cần nó.

Xử lý sự cố

Với các vấn đề không riêng của Linux, xem phần xử lý sự cố trong tài liệu hướng dẫn bản desktop.

Nó thoát ra ngay lập tức, hoặc chẳng có gì xảy ra cả

Chạy proxyma trong cửa sổ dòng lệnh để xem lỗi.

Nó không khởi động được, và nhật ký có nhắc tới cơ sở dữ liệu vector

Xem chromadb.log trong ~/.local/share/proxyma/logs/. Nguyên nhân thường gặp là một tiến trình còn sót lại từ lần chạy trước, thường sau một phiên bị buộc dừng đột ngột.

Phần thiết lập lần chạy đầu tiên thất bại

Hãy kiểm tra máy có kết nối được tới GitHub không. Nếu việc tải về bị dừng, hãy khởi động lại Proxyma.

~/.local/share/proxyma/ phải có quyền ghi và còn trống khoảng 3 GB. Nếu phần thiết lập Python thất bại giữa chừng, hãy xóa thư mục runtime/ ở đó rồi khởi động lại Proxyma.

Không có cửa sổ nào hiện ra, nhưng Proxyma có vẻ đang chạy

Hãy khởi động lại Proxyma từ trình đơn, thao tác này sẽ mở cửa sổ của nó. Nếu vẫn không được, hãy truy cập http://localhost:4246 trong trình duyệt.