neornotl/rightly

Rightly — repo release cho trợ lý hỏi đáp tiếng Việt về thông tin công và pháp luật

Python

2

52 commits

updated Sep 11, 2026

See the code

README

Rightly

Rightly là trợ lý hỏi–đáp tiếng Việt về thông tin công và pháp luật. Ứng dụng tìm nội dung liên quan trong kho nguồn đã cấu hình, tạo câu trả lời dễ đọc và hiển thị nguồn khi có đủ bằng chứng.

Lưu ý: Đây là MVP hỗ trợ tra cứu, không phải cơ quan nhà nước và không thay thế tư vấn pháp lý. Nguồn có thể thiếu hoặc chậm cập nhật; hãy kiểm tra lại với văn bản gốc hoặc cơ quan có thẩm quyền trước khi ra quyết định.

Dùng ngay

Repo này là bản dành cho người dùng và triển khai. Bộ test, benchmark, raw corpus và công cụ nghiên cứu nằm tại rightly-beta.

Chạy trên Windows

Yêu cầu Python 3.10 trở lên. Lần cài đầu cần Internet để tải thư viện và model đã chọn.

  1. Tải hoặc clone repo.
  2. Nhấp đúp start.bat.
  3. Mở http://localhost:8010 nếu trình duyệt không tự mở.

start.bat tạo môi trường riêng, cài thư viện, tạo .env từ mẫu và chọn cấu hình phù hợp với máy. Nếu cấu hình chọn Ollama nhưng máy chưa cài, trình khởi động sẽ hướng dẫn cài trước khi tiếp tục.

Chạy bằng dòng lệnh

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements-deploy.txt
Copy-Item .env.example .env
python webhook_server.py

Sau đó mở http://localhost:8010. Có thể chỉnh backend, model và API key trong .env; không commit .env hoặc khóa thật lên GitHub.

Những phần người dùng cần biết

Đường dẫnNội dung
start.batKhởi động nhanh trên Windows
.env.exampleMẫu cấu hình an toàn
web/Giao diện web
api/Điểm vào cho Vercel
app/Logic hỏi–đáp, truy xuất, safety, LLM/ASR/TTS
data/Dữ liệu runtime đã chuẩn bị sẵn
webhook_server.pyMáy chủ local/Docker
Dockerfile, render.yaml, vercel.jsonCấu hình triển khai

Quyền riêng tư và an toàn

  • Mặc định không commit .env, log, kết quả chạy hay file âm thanh.
  • Chỉ điền API key ở máy cá nhân hoặc secret của nền tảng triển khai.
  • Không đưa dữ liệu cá nhân hoặc hồ sơ pháp lý nhạy cảm vào bản public.
  • Câu trả lời do model sinh ra phải được đối chiếu nguồn trước khi sử dụng trong tình huống quan trọng.

Nhóm thực hiện

  • Trần Hoàng Sơn — phát triển sản phẩm
  • Lê Xuân Bách — nội dung pháp lý
  • Trương Quang Minh — truyền thông và điều phối pilot

Giấy phép

MIT

accessibility
legal-tech
openvino
public-services
rag
vietnamese

neornotl/rightly

Rightly — repo release cho trợ lý hỏi đáp tiếng Việt về thông tin công và pháp luật

Python

2

52 commits

updated Sep 11, 2026

See the code

README

Rightly

Rightly là trợ lý hỏi–đáp tiếng Việt về thông tin công và pháp luật. Ứng dụng tìm nội dung liên quan trong kho nguồn đã cấu hình, tạo câu trả lời dễ đọc và hiển thị nguồn khi có đủ bằng chứng.

Lưu ý: Đây là MVP hỗ trợ tra cứu, không phải cơ quan nhà nước và không thay thế tư vấn pháp lý. Nguồn có thể thiếu hoặc chậm cập nhật; hãy kiểm tra lại với văn bản gốc hoặc cơ quan có thẩm quyền trước khi ra quyết định.

Dùng ngay

Repo này là bản dành cho người dùng và triển khai. Bộ test, benchmark, raw corpus và công cụ nghiên cứu nằm tại rightly-beta.

Chạy trên Windows

Yêu cầu Python 3.10 trở lên. Lần cài đầu cần Internet để tải thư viện và model đã chọn.

  1. Tải hoặc clone repo.
  2. Nhấp đúp start.bat.
  3. Mở http://localhost:8010 nếu trình duyệt không tự mở.

start.bat tạo môi trường riêng, cài thư viện, tạo .env từ mẫu và chọn cấu hình phù hợp với máy. Nếu cấu hình chọn Ollama nhưng máy chưa cài, trình khởi động sẽ hướng dẫn cài trước khi tiếp tục.

Chạy bằng dòng lệnh

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements-deploy.txt
Copy-Item .env.example .env
python webhook_server.py

Sau đó mở http://localhost:8010. Có thể chỉnh backend, model và API key trong .env; không commit .env hoặc khóa thật lên GitHub.

Những phần người dùng cần biết

Đường dẫnNội dung
start.batKhởi động nhanh trên Windows
.env.exampleMẫu cấu hình an toàn
web/Giao diện web
api/Điểm vào cho Vercel
app/Logic hỏi–đáp, truy xuất, safety, LLM/ASR/TTS
data/Dữ liệu runtime đã chuẩn bị sẵn
webhook_server.pyMáy chủ local/Docker
Dockerfile, render.yaml, vercel.jsonCấu hình triển khai

Quyền riêng tư và an toàn

  • Mặc định không commit .env, log, kết quả chạy hay file âm thanh.
  • Chỉ điền API key ở máy cá nhân hoặc secret của nền tảng triển khai.
  • Không đưa dữ liệu cá nhân hoặc hồ sơ pháp lý nhạy cảm vào bản public.
  • Câu trả lời do model sinh ra phải được đối chiếu nguồn trước khi sử dụng trong tình huống quan trọng.

Nhóm thực hiện

  • Trần Hoàng Sơn — phát triển sản phẩm
  • Lê Xuân Bách — nội dung pháp lý
  • Trương Quang Minh — truyền thông và điều phối pilot

Giấy phép

MIT

accessibility
legal-tech
openvino
public-services
rag
vietnamese