# skyvern-ai/skyvern architecture

> Architecture diagram of the GitHub repository skyvern-ai/skyvern, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skyvern-ai/skyvern
- Repository: https://github.com/skyvern-ai/skyvern

## Overview

Skyvern automates browser workflows with LLM and computer-vision guidance, exposed through a no-code web UI and a Playwright-compatible SDK. A user defines a task or workflow, the API orchestrates planning and browser execution against a target website, then persists run state and artifacts for monitoring. The sampled frontend confirms Axios-backed queries, cached polling for active runs, schedule retrieval, browser-session history, profiles, tags, and copilot chats. Backend internals are represented only at the documented package-directory level because their source was not sampled.

Main entry points: [`skyvern-frontend/src/api/AxiosClient.ts`](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/api/AxiosClient.ts) (API Client), [`skyvern`](https://github.com/skyvern-ai/skyvern/tree/main/skyvern) (Browser Executor), [`skyvern-frontend/src/App.tsx`](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/App.tsx) (Web Application), [`skyvern-frontend/src/routes/workflows/hooks/useWorkflowRunQuery.ts`](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/workflows/hooks/useWorkflowRunQuery.ts) (Run Queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_frontend["Web Application<br/>[App.tsx]"]
  node_workflow_studio["Workflow Studio<br/>[WorkflowPage.tsx]"]
  node_task_builder["Task Builder"]
  node_run_monitor["Run Monitor<br/>[RunRouter.tsx]"]
  node_artifact_viewer["Artifact Viewer<br/>[Artifact.tsx]"]
  node_browser_sessions_ui["Browser Sessions"]
end

subgraph group_control["Workflow Control"]
  node_api_client["API Client<br/>[AxiosClient.ts]"]
  node_query_cache["Query Cache<br/>[QueryClient.ts]"]
  node_schedule_queries["Schedule Queries"]
  node_run_queries["Run Queries"]
  node_backend_api["Backend API"]
end

subgraph group_automation["Automation Runtime"]
  node_orchestrator["Workflow Orchestrator"]
  node_planner["Vision LLM Planner"]
  node_browser_executor["Browser Executor"]
  node_sdk["Playwright SDK<br/>[__init__.py]"]
end

subgraph group_state["Run State"]
  node_run_database[("Run Database")]
  node_artifact_store[("Artifact Storage")]
  node_browser_profiles["Browser Profiles"]
end

subgraph group_integrations["Integrations"]
  node_copilot_chats["Workflow Copilot"]
end

node_user(("User"))
node_target_websites["Target Websites"]
node_llm_provider["LLM Provider"]
node_credential_services["Credential Services"]
node_proxy_captcha["Proxy CAPTCHA Services"]

node_user -->|"uses"| node_frontend
node_user -->|"runs"| node_sdk
node_frontend -->|"opens"| node_workflow_studio
node_frontend -->|"opens"| node_task_builder
node_workflow_studio -->|"submits"| node_api_client
node_task_builder -->|"submits"| node_api_client
node_run_monitor -->|"reads"| node_run_queries
node_run_queries -->|"caches"| node_query_cache
node_run_queries -->|"fetches"| node_api_client
node_schedule_queries -->|"fetches"| node_api_client
node_browser_sessions_ui -->|"fetches"| node_api_client
node_api_client -->|"requests"| node_backend_api
node_sdk -->|"drives"| node_browser_executor
node_backend_api -->|"dispatches"| node_orchestrator
node_orchestrator -->|"plans"| node_planner
node_orchestrator -->|"executes"| node_browser_executor
node_orchestrator -->|"persists"| node_run_database
node_orchestrator -->|"stores"| node_artifact_store
node_planner -->|"prompts"| node_llm_provider
node_browser_executor -->|"navigates"| node_target_websites
node_browser_executor -->|"records"| node_run_database
node_artifact_viewer -->|"reads"| node_artifact_store
node_browser_profiles -->|"manages"| node_api_client
node_copilot_chats -->|"fetches"| node_api_client
node_browser_executor -.->|"authenticates"| node_credential_services
node_browser_executor -.->|"uses"| node_proxy_captcha

click node_frontend "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/App.tsx"
click node_workflow_studio "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/workflows/WorkflowPage.tsx"
click node_task_builder "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/tasks/create/CreateNewTaskFormPage.tsx"
click node_run_monitor "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/runs/RunRouter.tsx"
click node_artifact_viewer "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/tasks/detail/Artifact.tsx"
click node_browser_sessions_ui "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/browserSessions/BrowserSessions.tsx"
click node_api_client "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/api/AxiosClient.ts"
click node_query_cache "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/api/QueryClient.ts"
click node_schedule_queries "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/schedules/useOrganizationSchedulesQuery.ts"
click node_run_queries "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/workflows/hooks/useWorkflowRunQuery.ts"
click node_backend_api "https://github.com/skyvern-ai/skyvern/tree/main/skyvern"
click node_orchestrator "https://github.com/skyvern-ai/skyvern/tree/main/skyvern"
click node_planner "https://github.com/skyvern-ai/skyvern/tree/main/skyvern"
click node_browser_executor "https://github.com/skyvern-ai/skyvern/tree/main/skyvern"
click node_sdk "https://github.com/skyvern-ai/skyvern/blob/main/skyvern/__init__.py"
click node_run_database "https://github.com/skyvern-ai/skyvern/tree/main/skyvern"
click node_artifact_store "https://github.com/skyvern-ai/skyvern/tree/main/skyvern"
click node_browser_profiles "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/browserProfiles/BrowserProfilesPage.tsx"
click node_copilot_chats "https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/workflows/copilot/useInfiniteCopilotChatsQuery.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_workflow_studio,node_task_builder,node_run_monitor,node_artifact_viewer,node_browser_sessions_ui,node_user toneBlue
class node_api_client,node_query_cache,node_schedule_queries,node_run_queries,node_backend_api toneAmber
class node_orchestrator,node_planner,node_browser_executor,node_sdk toneMint
class node_run_database,node_artifact_store,node_browser_profiles toneRose
class node_copilot_chats,node_target_websites,node_llm_provider,node_credential_services,node_proxy_captcha toneIndigo
```

## Components

### User Experience

- [Web Application](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/App.tsx): `skyvern-frontend/src/App.tsx`
- [Workflow Studio](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/workflows/WorkflowPage.tsx): `skyvern-frontend/src/routes/workflows/WorkflowPage.tsx`
- [Task Builder](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/tasks/create/CreateNewTaskFormPage.tsx): `skyvern-frontend/src/routes/tasks/create/CreateNewTaskFormPage.tsx`
- [Run Monitor](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/runs/RunRouter.tsx): `skyvern-frontend/src/routes/runs/RunRouter.tsx`
- [Artifact Viewer](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/tasks/detail/Artifact.tsx): `skyvern-frontend/src/routes/tasks/detail/Artifact.tsx`
- [Browser Sessions](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/browserSessions/BrowserSessions.tsx): `skyvern-frontend/src/routes/browserSessions/BrowserSessions.tsx`

### Workflow Control

- [API Client](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/api/AxiosClient.ts): `skyvern-frontend/src/api/AxiosClient.ts`
- [Query Cache](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/api/QueryClient.ts): `skyvern-frontend/src/api/QueryClient.ts`
- [Schedule Queries](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/schedules/useOrganizationSchedulesQuery.ts): `skyvern-frontend/src/routes/schedules/useOrganizationSchedulesQuery.ts`
- [Run Queries](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/workflows/hooks/useWorkflowRunQuery.ts): `skyvern-frontend/src/routes/workflows/hooks/useWorkflowRunQuery.ts`
- [Backend API](https://github.com/skyvern-ai/skyvern/tree/main/skyvern): `skyvern`

### Automation Runtime

- [Workflow Orchestrator](https://github.com/skyvern-ai/skyvern/tree/main/skyvern): `skyvern`
- [Vision LLM Planner](https://github.com/skyvern-ai/skyvern/tree/main/skyvern): `skyvern`
- [Browser Executor](https://github.com/skyvern-ai/skyvern/tree/main/skyvern): `skyvern`
- [Playwright SDK](https://github.com/skyvern-ai/skyvern/blob/main/skyvern/__init__.py): `skyvern/__init__.py`

### Run State

- [Run Database](https://github.com/skyvern-ai/skyvern/tree/main/skyvern): `skyvern`
- [Artifact Storage](https://github.com/skyvern-ai/skyvern/tree/main/skyvern): `skyvern`
- [Browser Profiles](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/browserProfiles/BrowserProfilesPage.tsx): `skyvern-frontend/src/routes/browserProfiles/BrowserProfilesPage.tsx`

### Integrations

- [Workflow Copilot](https://github.com/skyvern-ai/skyvern/blob/main/skyvern-frontend/src/routes/workflows/copilot/useInfiniteCopilotChatsQuery.ts): `skyvern-frontend/src/routes/workflows/copilot/useInfiniteCopilotChatsQuery.ts`

### Other components

- **User**
- **Target Websites**
- **LLM Provider**
- **Credential Services**
- **Proxy CAPTCHA Services**

## Connections

- User → Web Application: uses
- User → Playwright SDK: runs
- Web Application → Workflow Studio: opens
- Web Application → Task Builder: opens
- Workflow Studio → API Client: submits
- Task Builder → API Client: submits
- Run Monitor → Run Queries: reads
- Run Queries → Query Cache: caches
- Run Queries → API Client: fetches
- Schedule Queries → API Client: fetches
- Browser Sessions → API Client: fetches
- API Client → Backend API: requests
- Playwright SDK → Browser Executor: drives
- Backend API → Workflow Orchestrator: dispatches
- Workflow Orchestrator → Vision LLM Planner: plans
- Workflow Orchestrator → Browser Executor: executes
- Workflow Orchestrator → Run Database: persists
- Workflow Orchestrator → Artifact Storage: stores
- Vision LLM Planner → LLM Provider: prompts
- Browser Executor → Target Websites: navigates
- Browser Executor → Run Database: records
- Artifact Viewer → Artifact Storage: reads
- Browser Profiles → API Client: manages
- Workflow Copilot → API Client: fetches
- Browser Executor → Credential Services: authenticates
- Browser Executor → Proxy CAPTCHA Services: uses
