System Architecture

How Mino works

Mino is an AI-powered web automation platform. Give it a URL and a goal — it provisions a remote browser, runs an AI agent that navigates and extracts data, and streams results back in real-time.

Web UI · REST API · MCP · Python SDK·Gemini-powered·Live browser streaming
Overview

System diagram

Click any component to dive deeper. Hover to see connections.

HTTP / SSEenqueueRun()SSE streamif codifiedprovision browsershadow / primaryboot microVMClient LayerWeb UI · REST API · MCP · SDKUX LabsNext.js · MySQL · RedisSQS QueueJob dispatchTask WorkerECS · Concurrency · BillingEVAADK · Gemini · 15 browser toolsNemoLangGraph · CodificationWADLBrowser provisioningTetraMicroVM · CDP proxy · ChromiumRedis Pub/Sub ↩ SSE to client
Data Flow

Request lifecycle

From user submission to structured results — every step of a Mino automation run.

User submits URL + goalClient

Via Web UI, REST API, MCP, or Python SDK

UX Labs creates run recordUX Labs

MySQL row + SQS message dispatched

Task Worker picks up jobTask Worker

Checks billing, acquires concurrency slot

EVA starts agent loopEVA

Gemini generates tool calls, Playwright executes

Browser provisioned in microVMTetra

Unikraft boots VM, Tetra proxies CDP

AI navigates, clicks, extractsEVA

Up to 150 steps, live-streamed via SSE

Structured results returnedClient

JSON output + browser cleaned up

Components

Building blocks

UX Labs

Frontend, REST API, MCP server, and SSE event bridge. The main entry point for everything.

Next.js 16React 19MySQLRedisClerk

tinyfish-io/ux-labs

Task Worker

SQS consumer that bridges the job queue with EVA. Handles concurrency, billing, and retries.

TypeScriptECSSQSRedis Lua

tinyfish-io/ux-labs → task-worker/

EVA

The AI brain. Google ADK + Gemini agent that drives the browser with 15 tools.

FastAPIGoogle ADKGeminiPlaywright

tinyfish-io/eva

WADL & Tetra

Browser infrastructure — WADL provisions browsers, Tetra runs them in microVMs with CDP proxy.

FastAPIUnikraftCDPTypeScript

tinyfish-io/wadl + tinyfish-io/unikraft-cdp

Nemo

Next-gen orchestration. Plans once with LLM, codifies to deterministic steps, replays without AI.

LangGraphAgentQLDatabricksFastAPI

tinyfish-io/web-agent

Reference

Repository map

RepoLanguagePurpose
tinyfish-io/ux-labsTypeScript (Next.js)Frontend, API, DB, MCP, Task Worker
tinyfish-io/evaPython (FastAPI)AI web automation service
tinyfish-io/web-agentPython (LangGraph)Nemo orchestration engine
tinyfish-io/wadlPython (FastAPI)API gateway + browser provisioning
tinyfish-io/unikraft-cdpTypeScriptTetra CDP proxy (current)
tinyfish-io/tetra—Tetra standalone (migration target)
tinyfish-io/tf-commonPythonShared library