robotframework-gemini 0.3.1__tar.gz → 0.3.3__tar.gz

robotframework_gemini-0.3.3/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: robotframework-gemini
+Version: 0.3.3
+Summary: Google Gemini oracles for Robot Framework: text-only and multimodal (image) assertions.
+Project-URL: Homepage, https://github.com/carlosnizolli/robotframework-gemini
+Project-URL: Documentation, https://github.com/carlosnizolli/robotframework-gemini/blob/main/README.md
+Project-URL: Repository, https://github.com/carlosnizolli/robotframework-gemini
+Project-URL: Issues, https://github.com/carlosnizolli/robotframework-gemini/issues
+Project-URL: Changelog, https://github.com/carlosnizolli/robotframework-gemini/releases
+Author: Carlos Nizolli
+License-Expression: MIT
+License-File: LICENSE
+Keywords: Gemini,LLM,QA,Robot Framework,multimodal,testing
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Robot Framework
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Requires-Dist: google-genai>=1.10.0
+Provides-Extra: browser
+Requires-Dist: robotframework-browser>=18.0.0; extra == 'browser'
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# robotframework-gemini
+
+**English** | [Português (Brasil)](README.pt-BR.md)
+
+Robot Framework **keyword library** for **Google Gemini** oracles: **text-only** evaluation (API payloads, logs, JSON, etc.) or **multimodal** checks with an image (PNG file or a **Robot Framework Browser** screenshot).
+
+- **Multimodal**: sends prompt text and the capture as a byte `Part` (`google-genai`).
+- **Recommended flow**: two inputs — **context** (test framing) and **evaluation** (criterion or yes/no question).
+- **Browser optional**: screenshot keywords need `Library    Browser`; text keywords work without a browser.
+
+## Installation
+
+```bash
+pip install robotframework-gemini
+```
+
+With Robot Framework Browser (Playwright) screenshot support:
+
+```bash
+pip install "robotframework-gemini[browser]"
+python -m pip install robotframework
+```
+
+Local development:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Environment variables and Library import
+
+| Variable / argument | Purpose |
+|---------------------|---------|
+| `GEMINI_API_KEY` | Gemini API key (required unless you pass `api_key` on the Library) |
+| `GEMINI_MODEL` | Model id (e.g. `gemini-2.5-flash`). If omitted, defaults to `gemini-2.5-flash`. |
+| `api_key` (import) | Overrides `GEMINI_API_KEY` at Library import |
+| `model` (import) | Overrides `GEMINI_MODEL` at Library import |
+
+By default the Library reads key and model from the environment. You can also pass them on import (useful in CI or suites that keep credentials in Robot variables):
+
+```robot
+*** Variables ***
+${GEMINI_API_KEY}    %{GEMINI_API_KEY}
+${GEMINI_MODEL}      gemini-2.5-flash
+
+*** Settings ***
+Library    GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+Model only (key still comes from the environment):
+
+```robot
+Library    GeminiLibrary    model=gemini-2.5-flash
+```
+
+Explicit package import (equivalent):
+
+```robot
+Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+> Do not commit a literal API key; prefer `%{GEMINI_API_KEY}` or CI secrets.
+
+## Keyword documentation
+
+- English: [docs/KEYWORDS.en.md](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.en.md)
+- Português: [docs/KEYWORDS.pt-BR.md](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.pt-BR.md)
+
+## Usage in Robot Framework
+
+> **Note:** examples use `Set Variable` and `Catenate` instead of the `VAR` keyword (Robot Framework 7.0+) to stay compatible with older Robot Framework versions.
+
+### Text only (no Browser)
+
+```robot
+*** Settings ***
+Library    GeminiLibrary
+
+*** Keywords ***
+Validate API response
+    ${context}=       Set Variable    {"status": "ok", "items": 3}
+    ${evaluation}=    Set Variable    Does the payload indicate success with items?
+    ${model_response}=    Gemini Evaluate Text    ${context}    ${evaluation}
+    Log    ${model_response}
+```
+
+### With a screenshot (Browser)
+
+Import **Browser** before **Gemini**:
+
+```robot
+*** Settings ***
+Library    Browser
+Library    GeminiLibrary
+
+*** Keywords ***
+Check screen against a neutral criterion
+    ${context}=       Set Variable    List filtered by Active status.
+    ${evaluation}=    Set Variable    Do all visible items show Active status?
+    ${model_response}=    Gemini Evaluate With Screen    ${context}    ${evaluation}
+    Log    ${model_response}
+```
+
+Recommended import (RobotCode, runtime, and PyPI):
+
+```robot
+Library    GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+Explicit package path (IDEs that prefer a full Python path):
+
+```robot
+Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+### IDE and RobotCode
+
+| Import form | Resolved by |
+|-------------|-------------|
+| `Library    GeminiLibrary` | Top-level `GeminiLibrary.py` module (installed in the wheel or via `src/` in a clone) |
+| `Library    robotframework_gemini.library.GeminiLibrary` | Standard Python package path |
+
+In a **repository clone**, without installing:
+
+- [`robot.toml`](robot.toml) — `python-path = ["src"]` for RobotCode/LSP
+- [`.vscode/settings.json`](.vscode/settings.json) — `extraPaths` for Pylance/Cursor
+
+With a local venv: `pip install -e ".[dev]"`, then reload the IDE window after changes.
+
+With an image file already saved:
+
+```robot
+Browser.Take Screenshot    ${OUTPUT_DIR}/screen.png
+${model_response}=    Gemini Evaluate With Image File    ${context}    ${evaluation}    ${OUTPUT_DIR}/screen.png
+```
+
+Verdict via prompt (first line) and 1–5 score:
+
+```robot
+${model_response}=    Gemini Evaluate With Screen    ${context}    ${evaluation}
+...    extra_instructions=Reply with one word on the first line: Yes or No.
+${verdict}=    Get Line    ${model_response}    0
+Should Be Equal As Strings    ${verdict}    Yes
+
+# Score 1–5: two steps (log the reason) or one-line shortcut
+${model_response}=    Gemini Evaluate Text Rating    ${context}    ${evaluation}
+${rating_score}=    Gemini Parse Rating    ${model_response}
+
+${rating_score}=    Gemini Evaluate Text Rating Score    ${context}    ${evaluation}
+```
+
+Details for the three rating keywords: [Scores 1–5 (EN)](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.en.md#scores-15-three-keywords-when-to-use).
+
+See also [examples/demo_template.robot](https://github.com/carlosnizolli/robotframework-gemini/blob/main/examples/demo_template.robot).
+
+## Tests
+
+```bash
+pytest
+```
+
+Tests mock `generate_content`; there are no real API calls.
+
+## License
+
+MIT.

robotframework_gemini-0.3.3/README.md

@@ -0,0 +1,166 @@
+# robotframework-gemini
+
+**English** | [Português (Brasil)](README.pt-BR.md)
+
+Robot Framework **keyword library** for **Google Gemini** oracles: **text-only** evaluation (API payloads, logs, JSON, etc.) or **multimodal** checks with an image (PNG file or a **Robot Framework Browser** screenshot).
+
+- **Multimodal**: sends prompt text and the capture as a byte `Part` (`google-genai`).
+- **Recommended flow**: two inputs — **context** (test framing) and **evaluation** (criterion or yes/no question).
+- **Browser optional**: screenshot keywords need `Library    Browser`; text keywords work without a browser.
+
+## Installation
+
+```bash
+pip install robotframework-gemini
+```
+
+With Robot Framework Browser (Playwright) screenshot support:
+
+```bash
+pip install "robotframework-gemini[browser]"
+python -m pip install robotframework
+```
+
+Local development:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Environment variables and Library import
+
+| Variable / argument | Purpose |
+|---------------------|---------|
+| `GEMINI_API_KEY` | Gemini API key (required unless you pass `api_key` on the Library) |
+| `GEMINI_MODEL` | Model id (e.g. `gemini-2.5-flash`). If omitted, defaults to `gemini-2.5-flash`. |
+| `api_key` (import) | Overrides `GEMINI_API_KEY` at Library import |
+| `model` (import) | Overrides `GEMINI_MODEL` at Library import |
+
+By default the Library reads key and model from the environment. You can also pass them on import (useful in CI or suites that keep credentials in Robot variables):
+
+```robot
+*** Variables ***
+${GEMINI_API_KEY}    %{GEMINI_API_KEY}
+${GEMINI_MODEL}      gemini-2.5-flash
+
+*** Settings ***
+Library    GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+Model only (key still comes from the environment):
+
+```robot
+Library    GeminiLibrary    model=gemini-2.5-flash
+```
+
+Explicit package import (equivalent):
+
+```robot
+Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+> Do not commit a literal API key; prefer `%{GEMINI_API_KEY}` or CI secrets.
+
+## Keyword documentation
+
+- English: [docs/KEYWORDS.en.md](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.en.md)
+- Português: [docs/KEYWORDS.pt-BR.md](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.pt-BR.md)
+
+## Usage in Robot Framework
+
+> **Note:** examples use `Set Variable` and `Catenate` instead of the `VAR` keyword (Robot Framework 7.0+) to stay compatible with older Robot Framework versions.
+
+### Text only (no Browser)
+
+```robot
+*** Settings ***
+Library    GeminiLibrary
+
+*** Keywords ***
+Validate API response
+    ${context}=       Set Variable    {"status": "ok", "items": 3}
+    ${evaluation}=    Set Variable    Does the payload indicate success with items?
+    ${model_response}=    Gemini Evaluate Text    ${context}    ${evaluation}
+    Log    ${model_response}
+```
+
+### With a screenshot (Browser)
+
+Import **Browser** before **Gemini**:
+
+```robot
+*** Settings ***
+Library    Browser
+Library    GeminiLibrary
+
+*** Keywords ***
+Check screen against a neutral criterion
+    ${context}=       Set Variable    List filtered by Active status.
+    ${evaluation}=    Set Variable    Do all visible items show Active status?
+    ${model_response}=    Gemini Evaluate With Screen    ${context}    ${evaluation}
+    Log    ${model_response}
+```
+
+Recommended import (RobotCode, runtime, and PyPI):
+
+```robot
+Library    GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+Explicit package path (IDEs that prefer a full Python path):
+
+```robot
+Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
+```
+
+### IDE and RobotCode
+
+| Import form | Resolved by |
+|-------------|-------------|
+| `Library    GeminiLibrary` | Top-level `GeminiLibrary.py` module (installed in the wheel or via `src/` in a clone) |
+| `Library    robotframework_gemini.library.GeminiLibrary` | Standard Python package path |
+
+In a **repository clone**, without installing:
+
+- [`robot.toml`](robot.toml) — `python-path = ["src"]` for RobotCode/LSP
+- [`.vscode/settings.json`](.vscode/settings.json) — `extraPaths` for Pylance/Cursor
+
+With a local venv: `pip install -e ".[dev]"`, then reload the IDE window after changes.
+
+With an image file already saved:
+
+```robot
+Browser.Take Screenshot    ${OUTPUT_DIR}/screen.png
+${model_response}=    Gemini Evaluate With Image File    ${context}    ${evaluation}    ${OUTPUT_DIR}/screen.png
+```
+
+Verdict via prompt (first line) and 1–5 score:
+
+```robot
+${model_response}=    Gemini Evaluate With Screen    ${context}    ${evaluation}
+...    extra_instructions=Reply with one word on the first line: Yes or No.
+${verdict}=    Get Line    ${model_response}    0
+Should Be Equal As Strings    ${verdict}    Yes
+
+# Score 1–5: two steps (log the reason) or one-line shortcut
+${model_response}=    Gemini Evaluate Text Rating    ${context}    ${evaluation}
+${rating_score}=    Gemini Parse Rating    ${model_response}
+
+${rating_score}=    Gemini Evaluate Text Rating Score    ${context}    ${evaluation}
+```
+
+Details for the three rating keywords: [Scores 1–5 (EN)](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.en.md#scores-15-three-keywords-when-to-use).
+
+See also [examples/demo_template.robot](https://github.com/carlosnizolli/robotframework-gemini/blob/main/examples/demo_template.robot).
+
+## Tests
+
+```bash
+pytest
+```
+
+Tests mock `generate_content`; there are no real API calls.
+
+## License
+
+MIT.

robotframework_gemini-0.3.1/README.md → robotframework_gemini-0.3.3/README.pt-BR.md

@@ -1,6 +1,8 @@
 # robotframework-gemini
 
-Biblioteca **Python** e **keywords do Robot Framework** para oráculos com **Google Gemini**: avaliação **só texto** (API, logs, JSON, etc.) ou **multimodal** com imagem (arquivo PNG ou captura do **Robot Framework Browser**).
+[English](README.md) | **Português (Brasil)**
+
+Biblioteca de **keywords do Robot Framework** para oráculos com **Google Gemini**: avaliação **só texto** (API, logs, JSON, etc.) ou **multimodal** com imagem (arquivo PNG ou captura do **Robot Framework Browser**).
 
 - **Multimodal**: envia o texto do prompt e a captura como `Part` em bytes (`google-genai`).
 - **Fluxo recomendado**: duas entradas — **contexto** (enquadramento do teste) e **avaliação** (critério ou pergunta objetiva).
@@ -59,29 +61,10 @@ Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_K
 
 > Evite commitar a chave literal no repositório; prefira `%{GEMINI_API_KEY}` ou secrets do CI.
 
-## Uso em Python (`GeminiOrchestrator`)
-
-```python
-from pathlib import Path
-from robotframework_gemini import GeminiOrchestrator
-
-orchestrator = GeminiOrchestrator()
-# ou explicitamente:
-# orchestrator = GeminiOrchestrator(api_key="...", model="gemini-2.5-flash")
-context = "Web dashboard with the 'Active' category filter applied."
-evaluation = "Do the visible list items match the selected category?"
-model_response = orchestrator.evaluate_with_image(context, evaluation, Path("screen.png"))
-```
-
-Para formato de saída restrito (ex.: Yes/No), use `extra_instructions`:
+## Documentação de Keywords
 
-```python
-model_response = orchestrator.evaluate_with_text(
-    context,
-    evaluation,
-    extra_instructions="Reply with one word only: Yes or No.",
-)
-```
+- Português: [docs/KEYWORDS.pt-BR.md](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.pt-BR.md)
+- English: [docs/KEYWORDS.en.md](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.en.md)
 
 ## Uso no Robot Framework
 
@@ -124,7 +107,7 @@ Import recomendado (RobotCode, runtime e PyPI):
 Library    GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
 ```
 
-Import explícito do pacote (Python / IDEs que preferem o caminho completo):
+Import explícito do pacote (IDEs que preferem o caminho completo):
 
 ```robot
 Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
@@ -166,19 +149,9 @@ ${rating_score}=    Gemini Parse Rating    ${model_response}
 ${rating_score}=    Gemini Evaluate Text Rating Score    ${context}    ${evaluation}
 ```
 
-Detalhes das três keywords de nota: [`docs/KEYWORDS.pt-BR.md#notas-15-três-keywords-quando-usar`](docs/KEYWORDS.pt-BR.md#notas-15-três-keywords-quando-usar).
-
-Consulte também [`examples/demo_template.robot`](examples/demo_template.robot).
-
-## Documentação de Keywords
-
-- Português: [`docs/KEYWORDS.pt-BR.md`](docs/KEYWORDS.pt-BR.md)
-- English: [`docs/KEYWORDS.en.md`](docs/KEYWORDS.en.md)
-
-## Compatibilidade
+Detalhes das três keywords de nota: [Notas 1–5 (pt-BR)](https://github.com/carlosnizolli/robotframework-gemini/blob/main/docs/KEYWORDS.pt-BR.md#notas-15-três-keywords-quando-usar).
 
-- `BrowserGeminiLibrary` permanece como alias de `GeminiLibrary` para suítes existentes.
-- Variáveis legadas (`LLM_API_KEY`, `LLM_API_KEY_LIA`, `LLM_LIA_MODEL`) são mapeadas para `GEMINI_*` ao importar o pacote.
+Consulte também [examples/demo_template.robot](https://github.com/carlosnizolli/robotframework-gemini/blob/main/examples/demo_template.robot).
 
 ## Testes
 

{robotframework_gemini-0.3.1 → robotframework_gemini-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "robotframework-gemini"
-version = "0.3.1"
+version = "0.3.3"
 description = "Google Gemini oracles for Robot Framework: text-only and multimodal (image) assertions."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -31,7 +31,7 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://github.com/carlosnizolli/robotframework-gemini"
-Documentation = "https://github.com/carlosnizolli/robotframework-gemini#readme"
+Documentation = "https://github.com/carlosnizolli/robotframework-gemini/blob/main/README.md"
 Repository = "https://github.com/carlosnizolli/robotframework-gemini"
 Issues = "https://github.com/carlosnizolli/robotframework-gemini/issues"
 Changelog = "https://github.com/carlosnizolli/robotframework-gemini/releases"
@@ -67,6 +67,7 @@ include = [
     "src/BrowserGeminiLibrary.py",
     "LICENSE",
     "README.md",
+    "README.pt-BR.md",
 ]
 
 [tool.pytest.ini_options]

{robotframework_gemini-0.3.1 → robotframework_gemini-0.3.3}/src/robotframework_gemini/__init__.py

@@ -18,4 +18,4 @@ __all__ = [
     "__version__",
 ]
 
-__version__ = "0.3.1"
+__version__ = "0.3.3"

robotframework_gemini-0.3.1/PKG-INFO

@@ -1,227 +0,0 @@
-Metadata-Version: 2.4
-Name: robotframework-gemini
-Version: 0.3.1
-Summary: Google Gemini oracles for Robot Framework: text-only and multimodal (image) assertions.
-Project-URL: Homepage, https://github.com/carlosnizolli/robotframework-gemini
-Project-URL: Documentation, https://github.com/carlosnizolli/robotframework-gemini#readme
-Project-URL: Repository, https://github.com/carlosnizolli/robotframework-gemini
-Project-URL: Issues, https://github.com/carlosnizolli/robotframework-gemini/issues
-Project-URL: Changelog, https://github.com/carlosnizolli/robotframework-gemini/releases
-Author: Carlos Nizolli
-License-Expression: MIT
-License-File: LICENSE
-Keywords: Gemini,LLM,QA,Robot Framework,multimodal,testing
-Classifier: Development Status :: 4 - Beta
-Classifier: Framework :: Robot Framework
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.10
-Requires-Dist: google-genai>=1.10.0
-Provides-Extra: browser
-Requires-Dist: robotframework-browser>=18.0.0; extra == 'browser'
-Provides-Extra: dev
-Requires-Dist: build>=1.0; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Requires-Dist: twine>=5.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# robotframework-gemini
-
-Biblioteca **Python** e **keywords do Robot Framework** para oráculos com **Google Gemini**: avaliação **só texto** (API, logs, JSON, etc.) ou **multimodal** com imagem (arquivo PNG ou captura do **Robot Framework Browser**).
-
-- **Multimodal**: envia o texto do prompt e a captura como `Part` em bytes (`google-genai`).
-- **Fluxo recomendado**: duas entradas — **contexto** (enquadramento do teste) e **avaliação** (critério ou pergunta objetiva).
-- **Browser opcional**: keywords de screenshot exigem `Library    Browser`; keywords de texto funcionam sem navegador.
-
-## Instalação
-
-```bash
-pip install robotframework-gemini
-```
-
-Com suporte a captura via Robot Framework Browser (Playwright):
-
-```bash
-pip install "robotframework-gemini[browser]"
-python -m pip install robotframework
-```
-
-Desenvolvimento local:
-
-```bash
-python -m pip install -e ".[dev]"
-```
-
-## Variáveis de ambiente e importação da Library
-
-| Variável / argumento | Função |
-|----------------------|--------|
-| `GEMINI_API_KEY` | Chave da API Gemini (obrigatória se não passar `api_key` na Library) |
-| `GEMINI_MODEL` | Modelo (ex.: `gemini-2.5-flash`). Se omitido, usa `gemini-2.5-flash`. |
-| `api_key` (import) | Sobrescreve `GEMINI_API_KEY` na importação da Library |
-| `model` (import) | Sobrescreve `GEMINI_MODEL` na importação da Library |
-
-Por padrão, a Library lê chave e modelo das variáveis de ambiente. Você também pode passá-los na importação (útil em CI ou suítes com credenciais em variáveis Robot):
-
-```robot
-*** Variables ***
-${GEMINI_API_KEY}    %{GEMINI_API_KEY}
-${GEMINI_MODEL}      gemini-2.5-flash
-
-*** Settings ***
-Library    GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
-```
-
-Só o modelo (chave continua vinda do ambiente):
-
-```robot
-Library    GeminiLibrary    model=gemini-2.5-flash
-```
-
-Import explícito (equivalente):
-
-```robot
-Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
-```
-
-> Evite commitar a chave literal no repositório; prefira `%{GEMINI_API_KEY}` ou secrets do CI.
-
-## Uso em Python (`GeminiOrchestrator`)
-
-```python
-from pathlib import Path
-from robotframework_gemini import GeminiOrchestrator
-
-orchestrator = GeminiOrchestrator()
-# ou explicitamente:
-# orchestrator = GeminiOrchestrator(api_key="...", model="gemini-2.5-flash")
-context = "Web dashboard with the 'Active' category filter applied."
-evaluation = "Do the visible list items match the selected category?"
-model_response = orchestrator.evaluate_with_image(context, evaluation, Path("screen.png"))
-```
-
-Para formato de saída restrito (ex.: Yes/No), use `extra_instructions`:
-
-```python
-model_response = orchestrator.evaluate_with_text(
-    context,
-    evaluation,
-    extra_instructions="Reply with one word only: Yes or No.",
-)
-```
-
-## Uso no Robot Framework
-
-> **Nota:** os exemplos usam `Set Variable` e `Catenate` em vez da keyword `VAR` (Robot Framework 7.0+) para manter retrocompatibilidade com versões anteriores do Robot Framework.
-
-### Só texto (sem Browser)
-
-```robot
-*** Settings ***
-Library    GeminiLibrary
-
-*** Keywords ***
-Validar resposta da API
-    ${context}=       Set Variable    {"status": "ok", "items": 3}
-    ${evaluation}=    Set Variable    O payload indica sucesso com itens?
-    ${model_response}=    Gemini Evaluate Text    ${context}    ${evaluation}
-    Log    ${model_response}
-```
-
-### Com captura de tela (Browser)
-
-Declare a biblioteca **Browser** antes de **Gemini**:
-
-```robot
-*** Settings ***
-Library    Browser
-Library    GeminiLibrary
-
-*** Keywords ***
-Checar tela por critério neutro
-    ${context}=       Set Variable    Lista filtrada por status Ativo.
-    ${evaluation}=    Set Variable    Todos os itens visíveis mostram status Ativo?
-    ${model_response}=    Gemini Evaluate With Screen    ${context}    ${evaluation}
-    Log    ${model_response}
-```
-
-Import recomendado (RobotCode, runtime e PyPI):
-
-```robot
-Library    GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
-```
-
-Import explícito do pacote (Python / IDEs que preferem o caminho completo):
-
-```robot
-Library    robotframework_gemini.library.GeminiLibrary    api_key=${GEMINI_API_KEY}    model=${GEMINI_MODEL}
-```
-
-### IDE e RobotCode
-
-| Forma de import | Quem resolve |
-|-----------------|--------------|
-| `Library    GeminiLibrary` | Módulo top-level `GeminiLibrary.py` (instalado no wheel ou via `src/` no clone) |
-| `Library    robotframework_gemini.library.GeminiLibrary` | Pacote Python padrão |
-
-No **clone do repositório**, sem instalar:
-
-- [`robot.toml`](robot.toml) — `python-path = ["src"]` para RobotCode/LSP
-- [`.vscode/settings.json`](.vscode/settings.json) — `extraPaths` para Pylance/Cursor
-
-Com venv local: `pip install -e ".[dev]"` e recarregue a janela do IDE após mudanças.
-
-Com arquivo já salvo:
-
-```robot
-Browser.Take Screenshot    ${OUTPUT_DIR}/tela.png
-${model_response}=    Gemini Evaluate With Image File    ${context}    ${evaluation}    ${OUTPUT_DIR}/tela.png
-```
-
-Veredito via prompt (primeira linha) e nota 1–5:
-
-```robot
-${model_response}=    Gemini Evaluate With Screen    ${context}    ${evaluation}
-...    extra_instructions=Responda com uma palavra na primeira linha: Sim ou Não.
-${verdict}=    Get Line    ${model_response}    0
-Should Be Equal As Strings    ${verdict}    Sim
-
-# Nota 1–5: duas etapas (log da justificativa) ou atalho em uma linha
-${model_response}=    Gemini Evaluate Text Rating    ${context}    ${evaluation}
-${rating_score}=    Gemini Parse Rating    ${model_response}
-
-${rating_score}=    Gemini Evaluate Text Rating Score    ${context}    ${evaluation}
-```
-
-Detalhes das três keywords de nota: [`docs/KEYWORDS.pt-BR.md#notas-15-três-keywords-quando-usar`](docs/KEYWORDS.pt-BR.md#notas-15-três-keywords-quando-usar).
-
-Consulte também [`examples/demo_template.robot`](examples/demo_template.robot).
-
-## Documentação de Keywords
-
-- Português: [`docs/KEYWORDS.pt-BR.md`](docs/KEYWORDS.pt-BR.md)
-- English: [`docs/KEYWORDS.en.md`](docs/KEYWORDS.en.md)
-
-## Compatibilidade
-
-- `BrowserGeminiLibrary` permanece como alias de `GeminiLibrary` para suítes existentes.
-- Variáveis legadas (`LLM_API_KEY`, `LLM_API_KEY_LIA`, `LLM_LIA_MODEL`) são mapeadas para `GEMINI_*` ao importar o pacote.
-
-## Testes
-
-```bash
-pytest
-```
-
-Os testes usam mocks de `generate_content`; não há chamadas reais à API.
-
-## Licença
-
-MIT.