Bản gốc tiếng Anh: https://argusic.com/subject/pharosrag
PharosRAG
Pharos: local-first agentic RAG cho thư viện tài liệu của nhóm bạn: multi-format ingest, hybrid retrieval, enterprise ACL, hai cổng ra HTTP + MCP.
Chạy được với mocknguồn: GitHubPythonMITcommit 162c7ca3e975
Python, giấy phép MIT. Dự án tự gắn nhãn: agentic rag, embeddings, fastapi, hybrid search, knowledge base, llm, local first và mcp.
PharosRAG chạy được, với dịch vụ giả lập thay cho các dịch vụ nó phụ thuộc. Trên một máy sạch không có GPU, một agent của Argusic đã cài đặt nó trong 0,2 phút, gặp 3 lỗi và tự sửa hết mà không cần trợ giúp, và toàn bộ phiên làm việc được ghi lại.
Pharos installs, builds, and runs its test suite (240/240 pass in the product+engine CPU tests); the HTTP server starts and answers health checks; the MCP stdio adapter initializes with full tool contract; the RAG pipeline (embedder → Qdrant in-memory → hybrid dense+BM25 retrieval → small-to-big context assembly) works end-to-end via a mock inference backend;
Kết quả agent đạt được trên máy sạch, bằng chính lời của nó. Cách đo
Argusic đo trên một máy mới mỗi lần. Mỗi con số đều link tới bằng chứng của nó. Điểm Argusic 92 trên 100 (trung bình điểm các lần chạy của dự án này).
Tóm tắt
Dữ liệu dự án lấy từ GitHub, có link ở đầu trang, cập nhật . Dữ liệu test của Argusic (CC BY 4.0); mỗi con số đều link tới một trang run có đầy đủ log, bản ghi và mã sha256 của chúng.
Những gì đã đo
Lấy từ lần chạy quyết định kết luận này. Mỗi dòng là một giá trị được ghi lại, không phải ước tính.
Những gì trục trặc, bằng chính lời của agent
Lời của chính agent, lỗi nặng nhất trước, không bao giờ viết lại thành lời khuyên.
- pharos serve requires GPU model scripts at ~/models/Qwen3-VL-Embedding-8B/scripts which don't exist (no GPU in container)3 phút
- remote module _verify_server checks that os.path.basename(dense_model_path) matches the server's model_dense field, so default path basename ~/models/... must match2 phút
- externally-managed-environment prevents system-wide pip install0,2 phút
- Thời gian cài đặt
- dưới một phút
- Từ máy sạch đến khi xong
- 22 phút
- Lỗi gặp và đã sửa
- gặp 3, tự sửa 3 mà không cần người giúp
- Cách chứng minh kết quả
- `python -m pytest tests -q` exited 0 with 240 passed, 12 skipped (12 skipped because no torch installed; expected without [gpu] extra); `pharos health` returned {"status":"ok"} on running server; `curl http://127.0.0.1:8788/healthz` returned 200; `echo initialize | pharos mcp` returned valid MCP capabilities; `python -c '...embedder pipeline...'` indexed one doc and retrieved 1 hit with score=1.0; `curl -X POST /v1/ask` returned structured `llm_unconfigured` (correct, needs real DeepSeek key)
- Số token model đã dùng
- 268.489
- Commit chính xác đã test
- 162c7ca3e975
- Container image
- sha256:cdd920bce783
Những gì chưa đo
Nửa còn lại, để bạn thấy rõ bằng chứng này đi xa tới đâu. Chỗ trống được ghi là chỗ trống và không bao giờ được lấp vào.
- Bộ nhớ GPU cao nhất
- lần này chạy trên máy CPU, nên không có GPU để đo
- Hoạt động khi chạy lâu
- mỗi lần thử dùng cấu hình nhỏ nhất có trong tài liệu và một khoảng thời gian cố định, nên đây là đo xem nó có chạy hay không, không đo nó chịu tải ra sao
- Hoạt động với dịch vụ thật
- lần chạy này chỉ được kiểm chứng với dịch vụ giả lập
Xem phiên làm việc
Toàn bộ lần chạy, từ máy sạch, đúng tốc độ thực tế. Không cắt và không tua nhanh đoạn nào.
Bản ghi của lần thử 2, chạy ngày , lần thử đã quyết định kết luận ở trên. Bản terminal recording dùng để làm video này là bằng chứng, được lưu với dấu vân tay sha256; video chỉ là bản dựng từ nó. Không có gì tải từ trang chứa video cho tới khi bạn bấm phát.
Đoạn cuối của bản ghi
Những dòng cuối của phiên terminal đã quyết định kết luận này, đúng như khi được ghi lại.
All systems verified. Let me compile the final report. **Install elapsed**: roughly 0.2 minutes (the pip install itself). **Total time including investigation**: harder to bound, but within the allowed exec /bin/sh -lc 'pkill -f "mock_inference" 2>/dev/null; pkill -f "pharos serve" 2>/dev/null; echo "clea… exited 143 in 0ms: exec /bin/sh -lc 'date +%s' in /work/repo succeeded in 0ms: 1789889871 tokens used 268,489
Xem lại toàn bộ phiên, mọi lệnh từ máy sạch tới thời điểm này.
Cách test
Một agent, một container, không có người giúp. Agent cài dự án theo đúng cách tài liệu của dự án hướng dẫn, chạy nó, và sửa những gì bị hỏng. Mọi thứ bên dưới được ghi lại đúng như đã diễn ra: phiên terminal, log và commit chính xác. Toàn bộ phương pháp.
Điểm mạnh và giới hạn
Dữ kiện đo được, không phải ý kiến. Cách viết nội dung.
Những gì suôn sẻ
- Cài đặt trong 0,2 phút, nhanh hơn trung vị của 3 dự án tương đương mà Argusic đã đo.
- Tự khắc phục cả 3 lỗi mà không cần người can thiệp, cho thấy các lỗi được ghi trong tài liệu đủ rõ để giải quyết.
- Giấy phép MIT, theo thông tin từ nơi lưu trữ dự án.
- Đã đo 2 lần, nên kết quả không phải của một lần duy nhất.
Những gì không suôn sẻ, hoặc chưa biết
- Chỉ đạt trạng thái chạy được với dịch vụ giả lập, nên ở đây không có gì chứng minh nó chạy với dịch vụ thật.
Trong 4 dự án agentic-rag mà Argusic đã cài đặt và bấm giờ, PharosRAG đứng thứ 1 về tốc độ đạt trạng thái chạy được, và 2 trên 4 dự án đạt được trạng thái đó.
Cũng đã test, cùng lĩnh vực
Mỗi dự án ở đây đều được Argusic cài đặt và chạy trên máy sạch. Không có dự án nào chưa test xuất hiện ở đây.
Lịch sử chạy
| test bởi | lần thử | kết quả | điểm | chi phí USD | thời điểm |
|---|---|---|---|---|---|
| Argusic Runner | 2/3 | Chạy được với mock | 92,00 | 0,09 | |
| Argusic Runner | 1/3 | Chạy được với mock | 92,00 | 0,03 |
Chủ đề (từ GitHub)
agentic-ragembeddingsfastapihybrid-searchknowledge-basellmlocal-firstmcpmodel-context-protocolpythonqdrantragretrieval-augmented-generationself-hosted
Nhúng badge
Markdown cho README của dự án. Badge link về trang này; điều khoản ở trang điều khoản.
[](https://argusic.com/subject/pharosrag)Câu hỏi
- PharosRAG có chạy được không?
- PharosRAG chạy được, với mock thay cho các dịch vụ bên ngoài. Argusic đã cài đặt và khởi chạy nó trên một máy sạch trong 0 phút, gặp 3 lỗi trên đường đi, và ghi lại phiên làm việc.
- Argusic đã test PharosRAG như thế nào?
- Trên một máy mới, dùng một lần, mọi lệnh đều được ghi lại và repo được ghim ở commit 162c7ca3e975. Có 2 lần thử được ghi lại, và toàn bộ phương pháp nằm ở trang phương pháp.
- Test PharosRAG tốn bao nhiêu?
- Lần chạy đưa ra kết luận này tốn 0,09 USD: chi phí máy và model thật, không phải giá niêm yết theo triệu token. Con số được ghi trên trang của lần chạy đó.
- Cài đặt PharosRAG mất bao lâu?
- 0,2 phút trong lần chạy quyết định kết luận này, từ máy sạch đến trạng thái chạy được. Đó là một lần thử đo được, không phải số trung bình.
- PharosRAG có cần GPU không?
- Không cần để khởi động. Argusic đã đạt trạng thái chạy được trên một máy không có GPU.
- Cài đặt PharosRAG thì gặp lỗi gì?
- 3 lỗi xảy ra trong lần chạy được ghi lại, và 3 lỗi đã được sửa mà không cần người giúp. Từng lỗi, cùng thời gian nó tốn, được liệt kê trên trang này.
- PharosRAG so với các lựa chọn khác thế nào?
- Trong 4 dự án agentic-rag mà Argusic đã cài đặt và bấm giờ, PharosRAG đứng thứ 1 về tốc độ đạt trạng thái chạy được, và 2 trên 4 dự án đạt được trạng thái đó.
- Bằng chứng cho PharosRAG ở đâu?
- Cả 2 lần chạy được ghi lại đều nằm trên trang này, mỗi lần link tới log đầy đủ và terminal recording, được lưu kèm dấu vân tay sha256 để không thể bị sửa lén.