How ipenywis/laya-ultrafast works
Laya Ultrafast is a local browser agent for completing narrow web tasks, such as searching flights or opening an article, without booking or purchasing. The principal workflow is: a user submits a goal in the loopback inspector; the agent plans required values, observes the current page, chooses an operation and target, executes it through Chrome, and repeats until visible completion or blockage. Local Laya supplies decisions, while an OpenAI-compatible text model supplies the one-time goal plan. TypeSafe Jev remains an optional hosted policy. Build, test, recording, and documentation tooling are omitted.
Components 17
Inspector Interface
- Demo Server
laya_ultrafast/demo.py - Inspector UI
laya_ultrafast/static/app.js
Agent Orchestration
- Agent Loop
laya_ultrafast/agent.py - Goal Rules
laya_ultrafast/questions.py - Visible Result
laya_ultrafast/agent.py
Browser Runtime
- Browser Session
laya_ultrafast/browser.py - Freshness Checks
laya_ultrafast/browser.py - DOM Snapshot
laya_ultrafast/snapshot.js
Decision Systems
- Laya Policy
laya_ultrafast/laya.py - Model Helpers
laya_ultrafast/model.py
External Systems
- Chrome Browser
- Local Laya Model
Other components
- User
- Target Websites
- Text Model Endpoint
- Hosted Jev Policy
- TypeSafe API
Connections 23
- User → Inspector UI: submits goal
- Inspector UI → Demo Server: calls commands
- Demo Server → Agent Loop: controls agent
- Agent Loop → Demo Server: reports state
- Demo Server → Inspector UI: serves state
- Agent Loop → Goal Rules: uses rules
- Agent Loop → Laya Policy: requests decision
- Laya Policy → Goal Rules: applies constraints
- Laya Policy → Local Laya Model: asks questions
- Laya Policy → Model Helpers: plans fields
- Model Helpers → Text Model Endpoint: sends goal
- Agent Loop → Model Helpers: uses text helper
- Agent Loop → Browser Session: observes page
- Browser Session → DOM Snapshot: extracts actions
- DOM Snapshot → Browser Session: returns page state
- Agent Loop → Freshness Checks: validates target
- Agent Loop → Browser Session: executes action
- Browser Session → Chrome Browser: drives CDP
- Chrome Browser → Target Websites: browses pages
- Browser Session → Agent Loop: returns result
- Agent Loop → Visible Result: detects completion
- Agent Loop → Hosted Jev Policy: uses hosted policy
- Hosted Jev Policy → TypeSafe API: requests Jev