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_URLsays. - 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
- Install LM Studio (free).
- Download
LocalAgentBrowser-CleanRoom-<version>-setup.exefrom 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.
- Setup asks which of the tested models to download through LM Studio, then downloads the Chromium browser the agent uses (about 150 MB, once).
- 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
- In LM Studio, load your model with a context length of 8192 and start the local server (Developer tab → Start Server).
- Start LocalAgentBrowser Clean Room: the Start-menu shortcut on Windows, or
localagentbrowserin a terminal. - 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.
- When it finishes, the report opens in your browser, or read
research_report.mdin 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.