원문: realZachi/pg-jev · 수집일: 2026-10-04 · 커밋
8d9598d· v0.2.1 · Stars 668 · Forks 46 · PostgreSQL License · 사이트 pgjev.com · PGXNjev
개요
Jev를 SQL 함수로 감싼 PostgreSQL 확장이다. WHERE jev(people, 'the name is European')처럼 조건을 말하듯 쓰면 테이블의 각 행을 Jev가 판정한다. 인덱스·임베딩·벡터 컬럼이 필요 없다. jev()는 보통의 boolean 함수라서 AND age > 40, 조인, GROUP BY, LIMIT과 그대로 조합된다. 2026-09-17에 0.1.0, 다음 날 0.2.0, 10-03에 0.2.1이 나왔고, 설치까지 에이전트 스킬에 맡기는 구성이다.
함수
| 함수 | 반환 | 쓰임 |
|---|---|---|
jev(row, 조건 [, 임계값]) | boolean | WHERE 술어. 임계값은 인자 → jev.threshold → 0.5 순 |
jev_prob(row, 조건) | float8 | 조건을 만족할 확률 0~1. 순위·컷오프 미정일 때 |
jev_choice(row, 질문, 옵션[]) | text | 가장 가능성 높은 옵션 |
jev_score(row, 질문, 단계[]) | float8 | 순서 있는 단계 위의 확률 가중 위치(_norm은 0~1) |
jev_confidence · jev_eval | float8 · jsonb | 답의 신뢰도, 확률·legend 전체 |
jev_stats() · jev_cache_clear() | jsonb · void | 요청·토큰·추정 비용·캐시 적중, 캐시 비우기 |
row는 컬럼이 아니라 테이블·뷰 별칭 자체다. 판단에 필요한 컬럼만 담은 뷰를 만들어 그 별칭에 호출하면 토큰도 줄고 노출 범위도 좁아진다.
동작 방식
- 테이블+조건의 첫 호출이 read-ahead를 시작해 물리적 순서(TID 범위 스캔, 뷰는 OFFSET 페이지)로 테이블을 스트리밍한다.
- 행을 20개씩 한 state에 묶고 행마다 예/아니오 Noul 질문을 붙여 요청한다. 요청당 약 270토큰 오버헤드가 나뉘어 행당 175토큰이 된다(1행 단독은 약 435).
- 최대
2 × jev.concurrency(기본 16)개 요청을 영속 HTTPS 연결로 동시에 보내고, 배치가 돌아오는 대로 행에 답한다.LIMIT은 진행 중 윈도 뒤에서 멈추고, 앞선 저렴한 조건이 거른 행은 보내지 않는다. - 답은 행 내용+질문 기준으로 세션 안에 캐시한다. 임계값을 바꾸거나 확률로 정렬하는 재실행은 무료다.
배치가 20행인 이유가 흥미롭다. Jev는 rows[i]를 위치로 찾아야 해서 배열이 길면 흔들린다. 저자 실측에서 120행은 100% 정확, 40행은 9298%, 80행은 77~94%였다. 20행은 40행보다 토큰이 4%만 더 들고 지연은 비슷하다. 0.2.0에서 기본값을 40에서 20으로 내린 근거다. 같은 릴리스에서 Noul 질문의 generic criteria를 뺐는데, 입력 토큰의 16%를 차지하면서 답은 바꾸지 않았다.
실측(유럽에서 API까지 약 190ms, 2,000행): 첫 실행 약 3.5초·약 $0.012, 재실행 약 50ms, 새 조건의 LIMIT 3은 약 0.6초. 0.1.0의 8.5초·8.4초에서 줄어든 값이다.
알아둘 제약
- 풀 스캔이 설계다.
jev()까지 도달한 모든 행이 API로 간다. 저렴한 조건을 앞에 쓰고, 공유 서버에는jev.max_rows_per_statement로 지출 상한을 건다. 플래너가 외부 호출 비용을 고려해 술어 순서를 바꿔 주지 않으므로 SQL을 그렇게 써야 한다. - 자체 호스팅 Postgres 14~17 +
plpython3u+ 슈퍼유저가 필수라 Supabase·Neon·RDS 같은 관리형 호스트에서는 못 쓴다.plpython3u는 신뢰되지 않는 언어여서 함수가 서버 OS 권한으로 실행된다. - 행 내용이 제3자 API로 나간다. 공유가 허용되지 않는 데이터에는 쓰면 안 된다.
- 서브쿼리·CTE의 행(익명 record 타입)은 read-ahead가 안 돼 한 건씩 요청된다. 베이스 테이블이나 뷰에서 호출해야 한다.
- 캐시는 고유 행/질문 쌍만큼 세션 안에서 커진다. 커넥션 풀의 세션마다 각자 캐시를 데운다.
로컬 Jev 호환 서버 (0.2.1)
jev.api_url을 POST /v1/systemone 계약을 따르는 서버로 돌리면 행이 네트워크를 떠나지 않고 행당 과금도 없다. README는 stuntd(답을 기록하고 질문마다 헤드를 학습해 판정이 점차 로컬로 옮겨 간다고 소개)와 laya-server를 예로 든다. API 키는 *.typesafe.ai 호스트에서만 필요하다(이슈 #3). 같은 wire API를 구현한 대안 서버로는 OpenJev가 있다. 단, jev_stats()의 토큰·비용 추정은 서버와 무관하게 TypeSafe 정가 기준이다.
에이전트 스킬
.agents/skills/pgjev/SKILL.md가 설치·쿼리 작성·설명·트러블슈팅을 맡는다. npx skills add realZachi/pg-jev로 넣고 “서버에 pgjev 설치해줘”라고 시키면 사전 점검(check_server.sh: 버전·plpython3u·슈퍼유저·키), 설치, CREATE EXTENSION jev CASCADE, 스모크 테스트까지 한다. 스킬이 쿼리를 쓸 때의 규칙(저렴한 조건 먼저, 산술·날짜는 SQL, 조건은 문자 그대로, 임계값은 분포를 보고, 비용 먼저 안내)은 fastcampus-jev의 “역할 분담 원칙”과 같은 결이다. 사람 대신 에이전트가 설치 문서를 읽고 실행하는 배포 방식이 이 저장소의 눈에 띄는 선택이다.
평가
- 좋은 점: Jev의 확률 출력이 SQL의 정렬·임계값·
GROUP BY와 자연스럽게 맞물리는 사례다. 문서가 풀 스캔·슈퍼유저 요건·데이터 유출을 숨기지 않고 앞에 둔다. 배치 크기를 정확도 실측으로 정한 점이 믿음직하다. - 주의할 점: 수치(정확도·지연·비용)는 모두 저자의 단일 환경 측정이고, 이 노트는 README·CHANGELOG·스킬 문서를 읽은 것이지 직접 설치·실행한 결과가 아니다. 저장소가 만들어진 지 3주가 안 됐고 설정 기본값이 빠르게 바뀌고 있다(0.2.0에서 batch_size·concurrency·timeout 등 변경). GitHub는 라이선스를 “Other”로 표기하지만
LICENSE는 PostgreSQL License라고 밝힌다.
관련 노트
- jev · moc-jev
- 2026-09-27-jev-mcp: 같은 Jev를 MCP 판단 도구로 감싼 서버 — SQL이 아니라 에이전트 도구 쪽 래퍼
- 2026-09-19-awesome-jev: Jev 기반 오픈소스 디렉토리
- 2026-09-30-ollama-jev-style-decision-models: 같은
/v1/systemone엔드포인트를 로컬에서 여는 Ollama 0.35.jev.api_url대상으로 쓸 수 있는지는 원문에서 확인되지 않았다