hass-web-proxy-lib
A library to proxy web traffic through Home Assistant integrations.
Decision gist · record as of 2026-08-14
Yes, if you are developing a Home Assistant integration that needs to proxy traffic. The library eliminates boilerplate for a common pattern, has no external dependencies, carries permissive licensing, and is actively maintained. Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >=3.14.2,<4.0; integration must be used within a Home Assistant environment with access to hass.http and async_get_clientsession().
- Low install friction with no runtime dependencies.
- Active maintenance with recent releases; last commit on 2026-08-03 and latest release on 2026-05-05 indicate ongoing support.
License · maintenance · safety
MIT (permissive) — MIT license permits use in proprietary and open-source projects with minimal restrictions; attribution required.
last release 2026-05-05 (101 days) · last repo commit 2026-08-03 · 2 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 606,717 downloads/mo, #5,789 on PyPI
Alternatives
Verify before relying
from hass_web_proxy_lib import ProxyView, ProxiedURL
class MyProxyView(ProxyView):
url = "/api/my_integration/proxy/"
name = "api:my_integration:proxy"
def _get_proxied_url(self, request):
return ProxiedURL(url="https://target.example.com/path")- Whether the library supports HTTP methods beyond GET (PUT, POST, DELETE, PATCH) in ProxyView or only in WebsocketProxyView.
- Performance characteristics and limits for concurrent proxy requests or large payloads.
- Whether authentication/authorization logic can be customized beyond the allow_unauthenticated flag in ProxiedURL.
What it is and what it does
hass-web-proxy-lib is a small library for Home Assistant integration developers that abstracts the mechanics of proxying web traffic (HTTP and WebSocket) through Home Assistant's built-in web server. Rather than being an integration itself, it provides reusable base classes—ProxyView for HTTP proxying and WebsocketProxyView for WebSocket proxying—that integration developers inherit from and customize by implementing a single method, _get_proxied_url(), to determine where each request should be routed.
The library handles the plumbing of receiving requests at a Home Assistant API endpoint, validating authentication, forwarding traffic to a target URL, and returning responses. It includes exception classes for common HTTP error conditions (400, 401, 403, 404, 410) that integrations can raise to signal errors, a ProxiedURL dataclass to configure per-request behavior, and test utilities (fixtures and handlers) to help integration developers write tests for their proxy implementations.
Use it for
- Build a Home Assistant integration that exposes a local device's web interface through Home Assistant without exposing the device directly to the internet.
- Create a custom integration that proxies API calls to a backend service, applying Home Assistant authentication and authorization rules.
- Test a Home Assistant integration's proxy logic using the provided local_server fixture and response handlers.
- Implement WebSocket proxying for integrations that need to relay real-time data streams through Home Assistant.
- Develop an integration that conditionally routes requests based on config entry data without writing HTTP server boilerplate.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are developing a Home Assistant integration that needs to proxy traffic.
The library eliminates boilerplate for a common pattern, has no external dependencies, carries permissive licensing, and is actively maintained. Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
Install
hass-web-proxy-lib on PyPI
Before you install
Low install friction with no runtime dependencies. Active maintenance with recent releases; last commit on 2026-08-03 and latest release on 2026-05-05 indicate ongoing support.
Requires Python >=3.14.2,<4.0; integration must be used within a Home Assistant environment with access to hass.http and async_get_clientsession().
License in practice
MIT license permits use in proprietary and open-source projects with minimal restrictions; attribution required.
Quickstart
from hass_web_proxy_lib import ProxyView, ProxiedURL
class MyProxyView(ProxyView):
url = "/api/my_integration/proxy/"
name = "api:my_integration:proxy"
def _get_proxied_url(self, request):
return ProxiedURL(url="https://target.example.com/path")Verify before relying
- Whether the library supports HTTP methods beyond GET (PUT, POST, DELETE, PATCH) in ProxyView or only in WebsocketProxyView.
- Performance characteristics and limits for concurrent proxy requests or large payloads.
- Whether authentication/authorization logic can be customized beyond the allow_unauthenticated flag in ProxiedURL.
Package facts
| License | MIT permissive |
| Python support | Capped below the current Python release <4.0,>=3.14.2 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 101 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 606,717 / month, #5,789 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Topic :: Home Automation |
Evidence: hass_web_proxy_lib-0.0.8-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “home assistant proxy library”
- hass-web-proxy-libProvides base classes and utilities for Home Assistant integrations…
- hass-nabucasahass-nabucasa is a Python library that provides Home Assistant with…
- matter-ble-proxyA Python client library that bridges BLE operations to a remote…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Extracts and distributes Homematic CCU configuration metadata (translations, easymodes, link profiles) from OCCU, OpenCCU, or RaspberryMatic sources via local filesystem or HTTP/HTTPS.
See also SocketSwap · websockets-proxy · PySocks · websockify · mitmproxy · jupyter-http-over-ws · httpx-ws · ha-ffmpeg · proxy.py · matter-ble-proxy