Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,6 @@ node_modules/
tests/.artifacts/
*.log
*.bak.*

# Model blobs live outside the repo (~/.jev-browser/models); this only guards a stray manual download.
*.gguf
18 changes: 18 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,6 +213,24 @@ whether the page changed, cost), `requests.jsonl` and `run.json`, with secrets r
| `chrome` | unattended runs, CI, no window | own profile dir, `--headless`, or `--cdp-url http://127.0.0.1:9222` to attach |
| `safari` | WebKit | enable Develop → Allow Remote Automation once |

### Judging tiers

Three judging backends serve the same `/v1/systemone` contract, and all three are first-class
options — but **hosted Jev is the default**: with no config file and no environment, a run uses
`https://api.typesafe.ai` (and a loopback `baseUrl` — a local model — is priced at $0).

```bash
jev-browser tier list # the three tiers: what each is, what it needs, how to start it, its port, its score, its bar
jev-browser tier status # what a run would use right now: baseUrl, tier, resolved goal_done bar, endpoint
jev-browser tier use kev # one tier's export line and start command (nothing is written unless you add --persist)
```

The GGUF readout (`node skills/jev-browser/bin/jev-local.mjs`, port 8092) needs no Python and
serves an Apple Silicon `llama.cpp` server; Kev (`node skills/jev-browser/bin/jev-kev.mjs`, port
8008) trades a Python venv, a 9.34 GB base and tens of GB of GPU memory for the accuracy tier. The
tier table with every measured number — scores, latency, disk, memory, each backend's `goal_done`
bar and the known holes — lives in [SKILL.md](skills/jev-browser/SKILL.md#judging-tiers).

## MCP server

`jev-browser mcp` speaks MCP over stdio with zero dependencies. Tools: `jev_browse`, `jev_observe`,
Expand Down
13 changes: 13 additions & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -197,6 +197,19 @@ jev-browser pick --question "Which link opens the plans page?" --candidate prici
| `chrome` | 无人值守、CI、不要窗口 | 独立 profile;`--headless`;或 `--cdp-url http://127.0.0.1:9222` 附着到已开启调试端口的 Chrome |
| `safari` | WebKit | 需在开发菜单打开一次"允许远程自动化" |

### 判定后端(tier)

三种判定后端共用同一个 `/v1/systemone` 契约,都是平级选项 —— 但**默认仍然是托管版 Jev**:不写配置、不设环境变量,运行走 `https://api.typesafe.ai`(loopback `baseUrl` 即本地模型,按 $0 计价)。

```bash
jev-browser tier list # 三个 tier:是什么、需要什么、怎么启动、端口、得分、goal_done 阈值
jev-browser tier status # 当前一次运行会用哪个:baseUrl、tier、解析出的阈值、端点状态
jev-browser tier use kev # 打印某个 tier 的 export 行和启动命令(除非加 --persist,否则不写配置)
```

表格与全部实测数字(得分、延迟、磁盘、内存、各后端 `goal_done` 阈值、已知短板)见
[`SKILL.md`](skills/jev-browser/SKILL.md#judging-tiers);`references/config.md` 只保留阈值 profile 细节。

## MCP server

`jev-browser mcp` 通过 stdio 提供 MCP,零依赖。工具:`jev_browse`、`jev_observe`、`jev_judge`、`jev_pick`、`jev_doctor`、`jev_config`。结果同时以 JSON 文本和 `structuredContent` 返回。见 [`references/mcp.md`](skills/jev-browser/references/mcp.md)。
Expand Down
468 changes: 468 additions & 0 deletions docs/local-backend-run-smoke.md

Large diffs are not rendered by default.

349 changes: 349 additions & 0 deletions docs/local-gguf-probe.md

Large diffs are not rendered by default.

Loading
Loading