Skip to content

Repository files navigation

ASIL: Replacing Screenshot-and-Click with Structured State and Semantic Actions

Agent-Software Interaction Layer
Structured state observations and code-executable semantic actions for software-operating agents.

ASIL project pagePaper PDFASIL modelsASIL benchmark tasksASIL training dataASIL runtime imagesGitHub codeApache 2.0 license

News: ASIL has been accepted to Findings of EMNLP 2026.

Project Page | Paper | Overview | Results | Install | Benchmark | Software Onboarding | Resources | Citation


Overview

Powerful code agents can execute scripts, call tools, and manage files, yet many important applications remain accessible primarily through graphical user interfaces. ASIL replaces the screenshot-and-click loop with an agent-native interface that exposes software through structured JSON observations and code-executable semantic actions, realized through the deepest feasible access path for each application.

We instantiate ASIL across 15 applications and a benchmark of 300 single-application and 80 multi-application tasks. The same task definitions, initial artifacts, and software-state validators are shared across ASIL and GUI control, isolating the effect of the observation-action interface. Structured observations and semantic actions also provide compact, verifiable traces for SFT and evaluator-backed on-policy RL.

This release contains the runtime protocol, 15-application adapters, GUI and native-interface baselines, independent raw-state validation, Docker/Singularity environments, and the assisted software onboarding framework described in the paper. The Paper link currently serves the accepted camera-ready PDF and will be updated to arXiv after the preprint is released.

Headline Results

Main ASIL scores on the 380-task benchmark from the accepted paper:

ModelASIL
Kimi K2.584.8
GPT-5.481.6
sonnet4.681.2
Qwen3.6-plus81.1
Qwen3.5-27B75.8

Matched repaired screenshot-control comparisons reported in the paper:

ModelASIL BudgetASILGUI BudgetScreenshot GUIASIL - GUI
GPT-5.415max81.650max6.6+75.0
sonnet4.615max81.250max26.6+54.6
sonnet4.615max81.215max17.9+63.3

Small-scale training under the ASIL modality:

ModelBaseSFTRL
Qwen3.5-2B58.072.174.4
Qwen3.5-9B66.680.482.2

Repository Scope

Included here:

  • structured observation/action protocols and adapter runtime;
  • adapters and action schemas for the 15 paper applications;
  • 300 single-application, 80 multi-application, 80 hard, and 60 easy tasks;
  • deterministic, agentic ASIL, CLI, screenshot GUI, UNO, and draw.io baselines;
  • asil.softwaregen qualification, generation, audit, host probe, Docker probe, and evidence-report commands;
  • Docker Compose and Singularity definitions, tests, and public release checks.

Training implementation, training-task generation, SFT demonstration generation, RL rollout/training code, paper sources, rebuttal records, and per-task evaluation trajectories or scores are intentionally not included. Benchmark tasks, training data, runtime images, and released checkpoints are hosted separately on Hugging Face.

Install

ASIL requires Python 3.11 or newer.

python3.11 -m venv .venv
source .venv/bin/activate
pip install -c constraints-host.txt -e ".[dev,eval]"

Run a no-key local smoke and the release inventory check:

pytest -q \
tests/test_protocol.py \
tests/test_softwaregen_examples.py \
tests/test_raw_validation.py
python scripts/validate_public_release.py .

Benchmark

Task-set indexes live in evaluation_examples/; each entry resolves to evaluation_examples/examples/<software>/<task_id>.json.

IndexTasksPurpose
test_full15.json300Single-application benchmark
test_multi_apps_80.json80Cross-application benchmark
test_full15_multi_apps_380.json380Main benchmark union
test_full15_realwork_hard.json80Held-out hard suite
test_easy60.json60Easier OSWorld-comparable band

The 15 applications are Inkscape, LibreOffice Calc, LibreOffice Writer, LibreOffice Impress, Blender, GIMP, OBS Studio, Gitea, code-server, Thunderbird, Nautilus, Kdenlive, Audacity, draw.io, and JupyterLab.

Run deterministic evaluation:

PYTHONPATH=src python scripts/run_benchmark.py \
--task-set test_full15.json \
--participant asil \
--asil-execution deterministic \
--output-dir results/full15 \
--output results/full15/results.json

Run an agentic ASIL participant after setting the provider key only in the environment or an untracked .env file:

PYTHONPATH=src python scripts/run_benchmark.py \
--task-set test_full15.json \
--participant asil \
--asil-execution agentic \
--provider openai \
--model gpt-5.4 \
--max-steps 15 \
--output-dir results/asil-agent \
--output results/asil-agent/results.json

Set ASIL_HYBRID_VISION=1 to supplement structured ASIL observations with the adapter's rendered screenshot when a compatible multimodal endpoint is used.

The screenshot GUI participant uses the same task definitions and evaluator:

PYTHONPATH=src python scripts/run_benchmark.py \
--task-set test_easy60.json \
--participant gui \
--provider openai \
--model gpt-5.4 \
--max-steps 50

Matched application-native baselines are available in scripts/run_uno_baseline.py and scripts/run_drawio_baseline.py.

Docker

The clean-device bootstrap builds the local eval and OBS images, starts the pinned service stack, runs a deterministic four-task smoke, validates runtime capabilities, and removes its dedicated Compose resources. No model API key is required.

bash scripts/bootstrap_rebuttal_docker.sh

The historical script filename is retained for command compatibility; its inventory now checks only this public release. See docs/docker-quickstart.md. Singularity definitions and runner instructions are in docs/singularity-backend.md.

Assisted Software Onboarding

asil.softwaregen turns reviewed evidence about an open file, native script, command, or HTTP interface into a declarative ASIL extension candidate. Runtime hosts and executable allowlists come from the reviewed profile, not the model. Generated bundles must pass static audit before any probe; actions require both an explicit action file and --allow-actions.

PYTHONPATH=src python -m asil.softwaregen catalog
PYTHONPATH=src python -m asil.softwaregen qualify \
examples/softwaregen/gitea_profile.json
PYTHONPATH=src python -m asil.softwaregen generate \
examples/softwaregen/gitea_profile.json \
--provider openai \
--model gpt-5.4 \
--output results/softwaregen/gitea
PYTHONPATH=src python -m asil.softwaregen audit \
results/softwaregen/gitea/extension.json

The released Gitea measurement starts after a 97-line evidence profile already exists. It used one model call and 24.832775 seconds for the post-profile generation stage, produced one observation view and two semantic operations, passed static audit with zero errors and warnings, and passed 3/3 host plus 3/3 Docker probes with repository-count restoration 2 -> 3 -> 2.

These measurements do not include interface discovery, profile authoring, custom bridge work, task/evaluator design, GUI synchronization, rendering, or total historical person-hours. The 15 existing adapters predate this generator; the catalog shows recurring access paths, not retrospective generation provenance. Sanitized evidence is under examples/softwaregen/.

Public Resources

ResourceLink
Benchmark taskssharryXR/asil-benchmark
SFT and RL training datasharryXR/asil-training-data
Runtime imagessharryXR/asil-benchmark-images
Qwen3.5-2B SFTsharryXR/asil-qwen35-2b-sft
Qwen3.5-2B RLsharryXR/asil-qwen35-2b-rl
Qwen3.5-9B SFTsharryXR/asil-qwen35-9b-sft
Qwen3.5-9B RLsharryXR/asil-qwen35-9b-rl
Model collectionASIL models

Per-task run artifacts such as screenshots, trajectories, and score files are not part of the public release.

Citation

If you find ASIL useful, please cite the accepted paper:

@inproceedings{xie2026asil,
title={{ASIL}: Replacing Screenshot-and-Click with Structured State and Semantic Actions},
author={Xie, Rui and Chen, Lu},
booktitle={Findings of the Association for Computational Linguistics: EMNLP 2026},
year={2026}
}

License And Contact

Code is released under Apache-2.0. Data and documentation are released under CC BY 4.0 unless an individual repository card states otherwise. Model checkpoints inherit the applicable base-model terms.

Questions: Rui Xie (sharryXR@sjtu.edu.cn) and Lu Chen (chenlusz@sjtu.edu.cn). Citation metadata is provided in CITATION.cff.

About

Official implementation of ASIL, an agent-native structured-state and semantic-action interface. Findings of EMNLP 2026.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages