UUV Assistant AI based, used to improve the life of testers and developers by generating cucumber phrases from the GUI.
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
uuv-assistant-ai
Assistant AI - Image-based test generation
AI-powered assistant that helps testers and developers generate Cucumber BDD test scenarios from GUI screenshots and HTML content.
What is uuv-assistant-ai?
uuv-assistant-ai is an AI-powered service that extends the UUV ecosystem by enabling AI assisted tests. It uses Vision Language Models (VLMs) and Large Language Models (LLMs) to:
- Classify images - Determine if image elements are decorative or informative (in that case it generate suitable image description)
This service integrates with the main @uuv/assistant or @uuv/assistant-desktop to provide a complete solution for E2E test generation.
Getting started
Prerequisites
- Python >=3.10, <3.15
Environment Variables
Create a .env file with the following variables:
Required (for API access)
LLM_API_URL=https://localhost:11434
LLM_API_KEY=your-api-key
LLM_MODEL=ministral-3:8b
VLM_API_URL=https://localhost:11434
VLM_API_KEY=your-api-key
VLM_MODEL=ministral-3:8b
Setup with pip
pip install uuv-assistant-ai
# After installing from PyPI
uuv-assistant-ai
The API will be available at http://localhost:8000
Setup with uv
uvx add uuv-assistant-ai[mlflow]
The API will be available at http://localhost:8000
Programmatic Usage
from uuv_assistant_ai.image_classifier import (
UUVMultipleImageDescriberAgent,
UUVImageClassifierAgent
)
from PIL import Image
# Describe images
describer = UUVMultipleImageDescriberAgent(
vlm_api_url="https://api.openai.com/v1",
vlm_api_key="your-key",
vlm_model="gpt-4-vision-preview"
)
image = Image.open("screenshot.png")
descriptions = describer(image)
# Classify images
classifier = UUVImageClassifierAgent(
llm_api_url="https://api.openai.com/v1",
llm_api_key="your-key",
llm_model="gpt-4"
)
result = classifier(
html_content="<html>...</html>",
css_selector=".element",
image_description="A button labeled Submit"
)
API Endpoints
1. Classify Image (Unified)
Stream image analysis results including description and classification.
curl -X POST "http://localhost:8000/api/v1/image/classify-unified" \
-F "html_content=<html>" \
-F "css_selector=.element-selector" \
-F "target_img_file=@screenshot.png"
Response (Server-Sent Events):
{"image_description": "A button labeled 'Submit' with blue background"}
{"is_decorative": false, "confidence": 0.95, "analysis_details": "This is a functional button..."}
2. Multiple Image Description
Describe multiple images in a single request.
curl -X POST "http://localhost:8000/api/v1/image/multiple-describe" \
-F "target_img_file=@screenshot.png"
Response:
{
"descriptions": [
{ "element": "button", "description": "Submit button" },
{ "element": "input", "description": "Text input field" }
]
}
3. Classify Image (Standard)
Classify an image using a pre-computed description, html_content and css_selector.
curl -X POST "http://localhost:8000/api/v1/image/classify" \
-F "html_content=<html>" \
-F "css_selector=.element-selector" \
-F "image_description=A button labeled Submit"
Response:
{
"is_decorative": false,
"confidence": 0.95,
"analysis_details": "This is a functional button..."
}
When to use which endpoint:
Quick Start (Recommended)
Use classify-unified for a simple, one-call approach that returns both image description and classification.
Advanced / Step-by-step
For more control, use the two-step approach:
multiple-describe- Get descriptions for all UI elements in one screenshotclassify- Classify each element using the pre-computed description
This step by approach is useful when you need to:
- Reuse descriptions for multiple operations
- Analyze multiple elements separately
- Build custom workflows with intermediate processing
Integration with UUV Ecosystem
The uuv-assistant-ai service integrates with:
@uuv/assistant- Web interface for test generation (integrates with this service)@uuv/cypress- Cypress execution engine@uuv/playwright- Playwright execution engine
Documentation
Full documentation: https://e2e-test-quest.github.io/uuv/
License
This project is licensed under the terms of the MIT license.
Authors
@luifr10- Louis Fredice NJAKO MOLOM@stanlee974- Stanley SERVICAL
Support UUV
If you want to help UUV grow, you can fund the project directly via Open Collective. Every contribution helps us dedicate more time and energy to improving this open-source tool.
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file uuv_assistant_ai-1.11.0.tar.gz.
File metadata
- Download URL: uuv_assistant_ai-1.11.0.tar.gz
- Upload date:
- Size: 384.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bea99bd335e3f73baaaff5a1f08361fbd0e660e2d54c14f53cd27d51c841db8f
|
|
| MD5 |
276ef800c0ad3187d7feee47adfde3b8
|
|
| BLAKE2b-256 |
7e3cb1038be730f3f1152707187c0fca59c2907266c85930aa59118646c3bfeb
|
Provenance
The following attestation bundles were made for uuv_assistant_ai-1.11.0.tar.gz:
Publisher:
uuv-github-ci.yml on e2e-test-quest/uuv
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
uuv_assistant_ai-1.11.0.tar.gz -
Subject digest:
bea99bd335e3f73baaaff5a1f08361fbd0e660e2d54c14f53cd27d51c841db8f - Sigstore transparency entry: 2026923719
- Sigstore integration time:
-
Permalink:
e2e-test-quest/uuv@fa0658177d2776d5a96de82b8e3c32c6d4d16d2b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/e2e-test-quest
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
uuv-github-ci.yml@fa0658177d2776d5a96de82b8e3c32c6d4d16d2b -
Trigger Event:
push
-
Statement type:
File details
Details for the file uuv_assistant_ai-1.11.0-py3-none-any.whl.
File metadata
- Download URL: uuv_assistant_ai-1.11.0-py3-none-any.whl
- Upload date:
- Size: 13.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df7998049e1cd211afb6dd21ae9918a4630ff141312b0a466d7fe1b7a6430456
|
|
| MD5 |
55389ef0a215750563ee466b34d29363
|
|
| BLAKE2b-256 |
b1900b9b0572e1b2f53082501dac2e36e8e3e024fcabfe2b790375efbfb4d3f5
|
Provenance
The following attestation bundles were made for uuv_assistant_ai-1.11.0-py3-none-any.whl:
Publisher:
uuv-github-ci.yml on e2e-test-quest/uuv
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
uuv_assistant_ai-1.11.0-py3-none-any.whl -
Subject digest:
df7998049e1cd211afb6dd21ae9918a4630ff141312b0a466d7fe1b7a6430456 - Sigstore transparency entry: 2026923925
- Sigstore integration time:
-
Permalink:
e2e-test-quest/uuv@fa0658177d2776d5a96de82b8e3c32c6d4d16d2b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/e2e-test-quest
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
uuv-github-ci.yml@fa0658177d2776d5a96de82b8e3c32c6d4d16d2b -
Trigger Event:
push
-
Statement type:
