auto-data-snapshot: 2026-09-20T15:36:19 (1 data files) — QUICKSTART.md

c83cc62940afd0533d4e109ff494fb5a1efae90f · 2026-09-20 15:37:17 -0700 · auto-commit-fleet

Files touched

A QUICKSTART.md

Diff

commit c83cc62940afd0533d4e109ff494fb5a1efae90f
Author: auto-commit-fleet <steve@designerwallcoverings.com>
Date:   Sun Sep 20 15:37:17 2026 -0700

    auto-data-snapshot: 2026-09-20T15:36:19 (1 data files) — QUICKSTART.md
---
 QUICKSTART.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/QUICKSTART.md b/QUICKSTART.md
new file mode 100644
index 0000000..855235e
--- /dev/null
+++ b/QUICKSTART.md
@@ -0,0 +1,37 @@
+# jev (jev-ultrafast) — Quickstart
+
+Installed: 2026-09-20 · `~/Projects/jev-ultrafast` · cloned from github.com/browser-use/jev-ultrafast (MIT)
+
+**What it is:** a browser agent that *chooses* an action from a numbered, indexed list of on-page
+elements instead of generating selectors/code. One natural-language goal in → it clicks/types/scrolls
+to completion. Minimal LLM use (only for typing text).
+
+## Status
+- [x] Cloned + `uv sync` (22 pkgs, Python 3.13 venv) — `jev` binary built & confirmed
+- [x] `.env` scaffolded from `.env.example`
+- [ ] **API keys** — required before it can run (see below)
+
+## Step 1 — add the two keys to `.env`
+```
+TYPESAFE_API_KEY=      # JEV / browser-use "typesafe" model
+TEXT_MODEL_API_KEY=    # OpenRouter key (Gemini/GLM/DeepSeek also work via OpenAI-compatible base URL)
+```
+
+## Step 2 — run (all commands are `!` pastes — classifier-gated for the agent)
+```bash
+# demo inspector (opens http://127.0.0.1:8766 → "Start demo → Run automatically")
+uv run --project ~/Projects/jev-ultrafast jev
+
+# one-off goal against a URL
+uv run --project ~/Projects/jev-ultrafast --env-file ~/Projects/jev-ultrafast/.env \
+  python examples/run.py --url "https://example.com" --goal "your narrow goal here"
+
+# check Chrome connection
+uv run --project ~/Projects/jev-ultrafast browser-harness --doctor
+```
+
+## Notes
+- Needs Chrome with remote debugging (allow when prompted by browser-harness).
+- Keep goals *narrow*; repeat `--goal` for an ordered list.
+- A "DONE" from the agent is not proof of success — verify the real outcome (per AGENTS.md).
+- Dev checks: `uv run ruff check .` · `uv run pytest` · `uv build`.

← 1231850 docs: announce the Cloud waitlist below the README title (#3 · back to Jev Ultrafast · auto-data-snapshot: 2026-09-22T12:49:04 (1 data files) — .en a2513a0 →