Skip to main content

LocalAgentBrowser Clean Room

Clean Room is a private edition of LocalAgentBrowser: an autonomous web research agent with checked answers, run by a language model on your own PC in LM Studio, with a Chromium browser you can watch.

The full edition can also use hosted AI models over the internet, if you turn that on. Clean Room doesn't have that option at all: the code for it is removed before the edition is built, not just switched off, and the build fails if any of it is left. What Clean Room connects to:

  • The model server: LM Studio on this PC, or another machine on your own network. Clean Room refuses any other address, whatever LMSTUDIO_BASE_URL says.
  • The search engine (DuckDuckGo) and the pages the agent reads, the same as a person browsing.
  • During setup only: the Chromium browser download, and the model you pick (from Hugging Face, through LM Studio).

Your objective, the pages read and the report stay on your PC. Each run writes its research log and report to its own folder.

Install

Windows: the installer

  1. Install LM Studio (free).
  2. Download LocalAgentBrowser-CleanRoom-<version>-setup.exe from the latest release and run it.
    • Windows may say "Windows protected your PC", because the installer isn't code-signed yet. Click More info → Run anyway.
    • It installs for your Windows account only, with no administrator rights, and brings its own Python.
    • It installs beside the full edition, in its own folder (LocalAgentBrowser Clean Room) with its own shortcuts, so you can have both.
  3. Setup asks which of the tested models to download through LM Studio, then downloads the Chromium browser the agent uses (about 150 MB, once).
  4. Open LocalAgentBrowser Clean Room from the Start menu or the desktop.

To remove it: Start menu → LocalAgentBrowser Clean Room → Uninstall, or Windows Settings → Apps. Your reports in Documents are kept.

Any system: pip

You need Python 3.10 or later and LM Studio.

python -m venv venv
venv\Scripts\activate
pip install localagentbrowser-cleanroom
python -m playwright install chromium

On macOS or Linux, activate with source venv/bin/activate instead. The package installs the same localagentbrowser command and module as the full edition, so install one or the other in a given environment, not both.

First run

  1. In LM Studio, load your model with a context length of 8192 and start the local server (Developer tab → Start Server).
  2. Start LocalAgentBrowser Clean Room: the Start-menu shortcut on Windows, or localagentbrowser in a terminal.
  3. Type your objective, for example What is the tallest mountain in Africa, and how tall is it in meters and in feet? A Chromium window opens and the agent starts working. The first step takes a minute or two on a CPU.
  4. When it finishes, the report opens in your browser, or read research_report.md in the folder you ran it from. Runs from the shortcut each get their own folder under Documents\LocalAgentBrowser runs.

A run takes about 10 to 60 minutes on a CPU. Press Ctrl+C at any time to stop; the report is still written with everything found so far.

Settings

Environment variable Default Meaning
LMSTUDIO_BASE_URL http://localhost:1234/v1 LM Studio's address: this PC or your own network only
LMSTUDIO_MODEL qwen2.5-7b-instruct Model identifier as LM Studio lists it
LMSTUDIO_API_KEY lm-studio A key, if your LM Studio server requires one
LMSTUDIO_CONTEXT_LENGTH 8192 Context length the model is loaded with
LAB_SIDE_BY_SIDE on On Windows, 0 keeps the console and the browser from being placed side by side

More

How the agent works, what it was tested on and its limitations are in the project README and How it works. Clean Room runs the same agent and the same checks as the full edition, from the same code.

MIT License; see LICENSE.

Metadata

Release files for localagentbrowser-cleanroom 1.67

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for localagentbrowser-cleanroom 1.67
File Size Uploaded Provenance Actions
localagentbrowser_cleanroom-1.67.tar.gz 195.6 kB With provenance Details for localagentbrowser_cleanroom-1.67.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for localagentbrowser-cleanroom 1.67
File Interpreter ABI Platform Actions
localagentbrowser_cleanroom-1.67-py3-none-any.whl Python 3 none any Details for localagentbrowser_cleanroom-1.67-py3-none-any.whl

Total release size: 301.2 kB

Release files / localagentbrowser_cleanroom-1.67.tar.gz

Download URL localagentbrowser_cleanroom-1.67.tar.gz
Size 195.6 kB
Tags Source
SHA-256 checksum
How to use checksums
4b591e97b039d9721af3c2775b8605bf9b84740475629214444d5ec1804110f5
BLAKE2b-256 checksum
How to use checksums
e9e686c7f33758b85354581b0f0bafac8a4ffe6a184536f6a249fe7593ef8da9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / localagentbrowser_cleanroom-1.67-py3-none-any.whl

Download URL localagentbrowser_cleanroom-1.67-py3-none-any.whl
Size 105.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
466e47cd7add280e1d7bc6812d6ce8f421763be8f1bff9ef05709aaad7f7e367
BLAKE2b-256 checksum
How to use checksums
42d3d3fcfcf33ae1e6e41a6e84a04eda71b7eb47c979a4ee6f94ce3e3f4181d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for localagentbrowser-cleanroom 1.67

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for localagentbrowser_cleanroom-1.67.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.67 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page