RoboScope

Robot Framework Test Management—
Built for Teams

Open-source web UI to run, analyze, and manage Robot Framework tests. Free, self-hosted, Apache 2.0.

Open Source Apache 2.0 Self-Hosted Python + Vue 3 SQLite / PostgreSQL

Why RoboScope?

Bridging the gap between Robot Framework and your team

If you've ever tried to get a team without deep command-line experience excited about Robot Framework, you know the pattern: the syntax makes sense, the keyword idea clicks — but then comes the setup. Clone a repo, create a virtual environment, install dependencies, run tests from the terminal, find and open output files.

This is exactly where the colleagues with the best test ideas drop out.

Robot Framework has everything it takes to be used by less technical users. The keyword-driven architecture is perfect for that. But the surrounding tooling still requires comfort with the terminal.

RoboScope closes exactly this gap: A web UI that lets the entire team — from QA testers to product owners — manage, run, and analyze tests without opening a terminal.

👥

For the whole team

QA engineers, testers, and product owners can create and run tests directly in the browser — no command line needed.

Instant feedback

Start tests, follow live progress, see results immediately — without setting up a CI pipeline first.

🏠

Self-hosted & offline

Everything runs on your machine or server. No cloud account, no vendor lock-in, no data shared with third parties.

Everything you need

Robot Framework test management in a modern web interface

🚀

Test Execution

Subprocess or Docker, live WebSocket updates, cron scheduling — start and monitor tests directly from the browser.

📁

Project & Git Management

Clone repos, switch branches, auto-sync. Integrated code explorer with Robot parser and CodeMirror editor.

🐍

Environment Management

Create and manage Python environments with uv. Install packages, run library checks, all in one place.

📊

Reports & Deep Analysis

Auto-parse output.xml. Detect trends, find flaky tests, 15 KPIs across 5 categories in the deep analysis.

🤖

AI Failure Analysis

LLM-powered root cause analysis and .roboscope → .robot generation. OpenAI, Anthropic, OpenRouter, or Ollama.

🔒

Roles & Access Control

RBAC with four levels: Viewer, Runner, Editor, Admin. JWT authentication, multi-user ready.

RoboScope in Action

Click a tab to explore the different areas

RoboScope Dashboard

Dashboard — Overview of all projects, recent test runs, and KPIs

RoboScope Execution

Execution — Start tests, follow live logs, and view results

RoboScope Explorer

Explorer — Browse, edit, and run Robot files directly

RoboScope Statistics

Statistics — Trends, flaky detection, and deep analysis with 15 KPIs

RoboScope AI Analysis

AI Analysis — LLM-powered failure analysis and .roboscope generation

15
Deep analysis KPIs
4
Languages (EN/DE/FR/ES)
555+
Backend tests
4
LLM providers

Ready in minutes

No cloud account needed. Everything runs locally on your machine.

ZIP Download (Offline)

No Git, no Node.js, no internet required. Only Python 3.10+ needs to be installed.

1

Download & extract

Download ZIP from GitHub Releases and extract.

2

Install

chmod +x install-mac-and-linux.sh ./install-mac-and-linux.sh
install-windows.bat
3

Start

./start-mac-and-linux.sh # http://localhost:8145
start-windows.bat REM http://localhost:8145

Docker Compose

PostgreSQL + Nginx, production-ready. Only requires Docker and Docker Compose.

1

Clone repository

git clone https://github.com/viadee/roboscope.git cd roboscope
2

Start production

docker compose up -d # http://localhost:8000
3

Or dev mode (SQLite)

docker compose -f docker-compose.dev.yml up # http://localhost:5173

Git Clone (Dev-Setup)

Edit source code and contribute. Requires Python 3.12+, Node.js 20+, and uv.

1

Prerequisites

# install uv curl -LsSf https://astral.sh/uv/install.sh | sh
2

Clone & Install

git clone https://github.com/viadee/roboscope.git cd roboscope cp backend/.env.example backend/.env make install
3

Start dev server

make dev # Backend: http://localhost:8000 # Frontend: http://localhost:5173

Default login for all methods: admin@roboscope.local / admin123

🎬

Demo Video coming soon

Tech Stack

Modern, proven technologies — no vendor lock-in

FastAPI SQLAlchemy 2.0 Pydantic v2 Vue 3 TypeScript Pinia Playwright uv SQLite / PostgreSQL Docker Chart.js CodeMirror 6 WebSocket

What's next?

Current roadmap — ideas and pull requests are welcome

🚧

Visual editor for .robot files

Map the keyword-driven structure as a form — for everyone who prefers forms over text files. Visually edit Settings, Variables, Test Cases, and Keywords.

📦

Offline archive analysis

Upload and analyze old report ZIPs — without a Git repository or running environment. Evaluate historical data anytime.

UI refinements & accessibility

General polish: loading animations, error states, empty states, ARIA labels, and keyboard navigation.

What's missing for you?

RoboScope thrives on feedback. What would make this tool useful for your workflow? Where does it fall short? Issues, ideas, and pull requests are very welcome.