$ cat ./blog/gen-ai/he-sinh-thai-jev.md
seriesDecision model: khi AI ra quyết định thay vì viết chữbài 3

Hệ sinh thái JEV: SDK chính thức, cộng đồng và các bản System One mở

Bài 3 series Decision model: danh sách các tool và repo quanh JEV, chia theo ba tầng — chính thức (org typesafe-ai), cộng đồng, và bản mở / self-host. Mỗi tool gồm tên, link và một dòng mô tả. Repo kiểm ngày 30/09/2026.

~/diagrams/he-sinh-thai-jev/jev-ecosystem-map.htmltương tác
mở riêng ↗
HìnhLuồng chính thức đi từ JEV (model đóng, không công bố weights) qua TypeSafe API POST /v1/systemone, tới SDK chính thức (Python, JS, adapter chạy LLM), rồi tới integration chính thức như node n8n và skills. Dự án cộng đồng bọc SDK thành integration riêng (Spring AI, neurolink) và ứng dụng (browser agent, guard, search). Nhánh bản mở chạy model mở như Qwen, ModernBERT, Gemma sau một server tương thích (Kev, LocalJev, ollaya) nói cùng giao thức, nên SDK chính thức trỏ sang được. Hình chỉ gom nhóm; danh sách đầy đủ ở các phần 01–03.
node tầng chính thức (TypeSafe)node tầng cộng đồngbản mở / self-host (hộp xám, cạnh nét đứt tím)

Ở bài 2, ta mở một lần gọi JEV từ bên trong: request, response có kiểu kèm xác suất, và policy trong code. Bài này nhìn ra xung quanh: những tool và repo nào đang được xây quanh JEV.

Danh sách chia theo một trục: ai chịu trách nhiệm cho repo đó. Khi chọn một thứ để dùng, câu hỏi đầu tiên là nếu nó hỏng thì ai sửa, nên ba tầng dưới đây cần ba mức tin cậy khác nhau:

  1. Chính thức: repo trong org typesafe-ai, do TypeSafe duy trì.
  2. Cộng đồng: dự án ngoài TypeSafe, gọi JEV thật qua SDK hoặc HTTP.
  3. Bản mở / self-host: không gọi JEV, mà chạy model mở sau một server nói cùng giao thức POST /v1/systemone.

Hình 1 ở đầu bài vẽ ba tầng này. Mô tả mỗi tool lấy theo README hoặc phần mô tả của chính repo, kiểm ngày 30/09/2026; blog chưa kiểm các claim trong đó.


01Tầng chính thức

Repo trong org typesafe-ai, được tài liệu chính thức và trang PyPI của TypeSafe trỏ tới:

  • typesafe-sdk-python — SDK Python chính thức (PyPI typesafe-sdk), bài 2 dùng SDK này.
  • typesafe-sdk-js — SDK TypeScript/JavaScript chính thức.
  • system-one-adapter-python — giữ interface system_one của SDK nhưng trả lời bằng LLM (OpenAI, Anthropic, Gemini), để so sánh với JEV.
  • skills — agent skills để coding agent biết cách gọi System One API.
  • n8n-nodes-typesafe-ai — node n8n chính thức.
  • WorkflowEvals — code tái lập kết quả trên evals.typesafe.ai.

02Tầng cộng đồng

TypeSafe Community (TypeSafeAI)

Org TypeSafeAI có tên gần giống org chính thức nhưng tự ghi là “UNOFFICIAL organization made for community repos”, nên thuộc tầng cộng đồng.

  • typesafe-router — chọn model hoặc tool bằng một câu Choice.
  • jev-harness — harness cho coding agent: LLM đề xuất, JEV trả lời câu hỏi hẹp về đề xuất, code quyết định.
  • typesafe-playground — playground nhiều use case.
  • clarity-judge — chấm chất lượng bài viết theo nhiều trục.
  • typesafe-ui — bộ component UI.

Ứng dụng

SDK, integration và CLI

Danh sách tổng hợp


03Tầng bản mở / self-host

Nhánh này chạy model mở thay cho JEV. Các server bên dưới nói cùng giao thức nên SDK chính thức trỏ sang được qua base_url, nhưng model phía sau không phải JEV.

Server và runtime tương thích

  • jaredpalmer/kev — decision model tự train trên Qwen (0.8B–27B), có weights và server tương thích.
  • githubnext/localjev — bridge TypeScript/Bun của GitHub Next, trả response kiểu JEV từ DiffusionGemma.
  • razorback16/openjev — server tương thích JEV trên DiffusionGemma.
  • ekzhang/openjev-sglang — endpoint tương thích JEV trên model mở, chỉ chạy prefill.
  • ollaya-dev/ollaya — chạy decision model mở local sau một API tương thích TypeSafe, theo kiểu Ollama.

Model mở


04Tổng kết

  • Chính thức chỉ có sáu repo trong org typesafe-ai: hai SDK, adapter LLM, skills, node n8n và WorkflowEvals. Kiểm tính chính thức bằng cách đi từ docs và PyPI của TypeSafe ra repo.
  • Cộng đồng gồm org TypeSafe Community (không chính thức) và các nhóm khác, gọi JEV thật để chọn thao tác, chấm context, chấm rủi ro hay chọn nguồn.
  • Bản mở / self-host gồm server tương thích và model mở; cùng giao thức nhưng không phải JEV, nên ngưỡng chọn trên JEV phải đo lại khi đổi sang.

Bài tiếp theo, bài 4, đi từ danh sách này về một ứng dụng cụ thể: thiết kế một Chrome extension trích xuất dữ liệu web với JEV, theo cùng cách jev-ultrafast để JEV chỉ chọn còn code thực thi. Nếu chưa đọc hai bài trước, bài 1 giải thích vì sao lớp model này tồn tại, và bài 2 đi qua schema, ba kiểu câu hỏi và cách biến xác suất thành hành động.


Tài liệu tham khảo

Nguồn chính thức của TypeSafe AI

Repo cộng đồng và bản mở

  • Link và mô tả của từng repo ở phần 01–03 lấy theo README của chính repo, kiểm ngày 30/09/2026.
  • TypeSafe Community — org TypeSafeAI (mô tả “UNOFFICIAL organization”)

Ghi chú của tác giả

  • Ghi chú gốc: “JEV (TypeSafe AI) — Toàn cảnh ứng dụng & mã nguồn mở GitHub” (Notion). Khi viết bài đã sửa: org TypeSafeAI chuyển sang tầng cộng đồng, bổ sung n8n-nodes-typesafe-ai và WorkflowEvals vào tầng chính thức. Không đưa vào bài các app chỉ có tên mà không có link.

Trương Đức Dũng

AI Engineer - Hà Nội

Tập trung vào LLM, RAG và các hệ thống AI cần chạy ổn định trong môi trường vận hành thật.