Resurf

AI Agents & Assistants

A test framework that provides realistic, stateful, reproducible synthetic web environments for evaluating AI browser agents

Python Latest v0.1.1 · 2mo ago Security brief →

Features

Synthetic e‑commerce site (FastAPI + React + SQLite) running in a single Docker container
Deterministic environment with seedable state and auditable success evaluation via database snapshots
Injectable failure modes (latency, payment errors, server failures) configurable per task
Multiple adapter integrations (browser‑use DOM/AX‑tree, Stagehand Node bridge, vision‑only baseline)
Trajectory recording of DOM snapshots, screenshots, actions, token counts and latencies

View all 2 releases →

v0.1.0 New feature 2mo

Notable features

resurf SDK with Environment, Task, Runner, Trajectory and adapter ABCs
shop_v1 synthetic e-commerce site (FastAPI + React + SQLite) with modifier middleware
Adapters: browser-use, stagehand, vision_baseline

Full changelog

Initial public release.

resurf SDK (import resurf): Environment, Task, Runner, Trajectory, adapter ABC.
shop_v1 synthetic e-commerce site (FastAPI + React + SQLite) with
modifier middleware (latency, payment_outcome, server_error_rate,
session_ttl, frozen_time).
Adapters: browser-use, stagehand, vision_baseline.
~10 failure-mode templates and ~10 bundled tasks across find / cart /
checkout / account / adversarial / mobile.
CLI: resurf task new | from-template | validate | try | list.
resurf-models: shared SQLModel schema + deterministic seed_database.