Skip to content

Dethrottled 1.0 — autonomous web evidence and native browser control

Choose a tag to compare

@davidjangel davidjangel released this 02 Nov 08:41
· 126 commits to main since this release

Dethrottled gives agents one self-hosted, keyless interface for discovering sources, reading evidence and operating a real browser. Its reading workflow escalates through HTTP, TLS impersonation, rendering and a headed browser, then presents retained evidence, provenance, gaps and concrete continuation actions.

What 1.0 delivers

  • A complete default Compose stack: API, Patchright browser, SearXNG, Crawl4AI and MSG/XLSB parsing. Native documents, OCR and MiniLM/E5 corpus models are included in the API image. No GPU, API key or .env file is required.
  • Automatic, bounded recovery: publisher representations, lazy content, expandable details, primary application responses and visitor state can be reached through the normal reading workflow. Agents can continue manually through /drive when needed.
  • Real browser operation: native controls, frames, popups, downloads, scoped sessions, operation replay and persistent checkpoints. MCP exposes the complete browser action vocabulary.
  • Evidence agents can continue: retained documents, page/row/range reads, source pixels where available, partial-content diagnostics and explicit provenance. Mixed error banners produce warnings without deleting useful material.
  • Optional local speech and PDF layout: docker compose --profile full up -d --build starts both; the API discovers them automatically. First use downloads model weights. These profiles require more memory than the default stack.
  • Portable, verifiable packaging: pinned Python runtime packages, baked corpus models and offline verification; native AMD64/ARM64 build and functional gates. Source installs remain available through PyPI.

All 14 CI checks passed on the exact release commit, including native AMD64/ARM64 fresh-stack contracts and restart restoration: release CI. Machine-readable release verification and both architectures' functional evidence are attached below.

Recorded evidence

  • 648 tests passed locally; 15 skipped and two live-network tests deselected.
  • Fresh default stack without GPU or .env: 20/20 functional contracts plus restart restoration passed locally.
  • 22/22 controlled parser tasks passed. On the known pollution regression set, detections improved from 6/8 to 8/8; false flags stayed 0/10 and facts retained stayed 18/18. These are fixture results, not a population accuracy score.
  • Three fresh Reddit thread sessions on software and three with GPU recovered the predefined facts and exercised native comment-sort controls. Median navigation/read times were approximately 1.93s and 1.76s on the test host; this small sample does not establish a GPU advantage.
  • Actual authenticated MCP/REST probes and a fresh agent conversation completed the tested workflows. This is not a general agent success-rate estimate.

Crunchbase and G2 remained blocked, and CarGurus yielded no usable text. Dethrottled does not promise every source, solve every CAPTCHA, verify an agent's final answer or claim superiority to paid engines. OCR, speech and inferred layout require inspection when accuracy matters.

The release-gate report preserves protocols, timings, negative results and CI verification. Start with the documentation, agent integration and deployment configuration.

Install or upgrade

For the complete engine:

git clone https://github.com/halonyx-io/dethrottled.git
cd dethrottled
git checkout v1.0.0
docker compose up -d --build

For the Python package and optional Python readers:

python -m pip install --upgrade 'dethrottled[all]'

The Python package does not install Docker services, system OCR programs or model weights. Existing deployments must rebuild/recreate the changed services and update their adapters; publishing this release does not restart running installations. Preserve data/checkpoints and follow the upgrade guide.

Package publication verified

PyPI 1.0.0 was published successfully through the current repository's Trusted Publisher. Both PyPI file hashes match the wheel/source assets attached here. A fresh base install from the public index imports successfully and runs the CLI as version 1.0.0. See the attached publication-verification.json and SHA256SUMS.