---
id: lomond
version: "0.3.3"
license: unclear
license_treatment: permissive
maintenance: active
---

# lomond — Websocket Client Library

License: permissive · Maintenance: active · Downloads: 937.5K/mo

## What it is and what it does

Lomond is a WebSocket client that wraps raw WebSocket connections into an event-driven interface. Instead of managing threads or callbacks, you construct a WebSocket object and iterate over it, receiving event objects for each connection state change and incoming message. The library handles the WebSocket handshake and protocol details internally, yielding events like Connecting, Connected, Ready, Binary, Text, Poll, Closed, and Disconnected as the connection progresses.

The package depends only on six for Python 2/3 compatibility and is designed for straightforward, synchronous WebSocket consumption. It's useful when you want to read from a WebSocket in a simple loop without concurrent connection management, though the gap between the latest release (2018) and current date means you should verify compatibility with modern Python versions before relying on it for new projects.

Use it for:

- Build a simple WebSocket client that polls a server and processes incoming text or binary messages in a single event loop
- Connect to public echo or test WebSocket servers to verify connectivity or debug protocol behavior
- Implement a basic real-time data consumer that receives updates from a WebSocket and processes them sequentially
- Create a command-line tool that maintains a persistent WebSocket connection and reacts to server events

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Lomond is a WebSocket client library that converts WebSocket connections into an event stream, allowing you to iterate over connection and message events without threads or callbacks.

Yes, if you need a lightweight, event-driven WebSocket client for Python and are comfortable with a library whose latest release is from 2018. The active repository and permissive license are positive signals, but verify Python version compatibility for your target environment before committing to it in new projects. For modern applications, consider whether a more recently maintained alternative better suits your needs.

## Install

pip install lomond
uv add lomond
poetry add lomond

## Installing lomond

Before you install: Low install friction with a single lightweight dependency (six). The package is marked as active with recent repository activity (last commit 2026-07-06), though the latest PyPI release dates to 2018-09-21.

License in practice: Licensed under a permissive BSD license, allowing commercial and private use with minimal restrictions.

Quickstart:

from lomond import WebSocket

websocket = WebSocket('wss://echo.websocket.org')
for event in websocket:
    if event.name == 'text':
        print(event.text)
    elif event.name == 'poll':
        websocket.send_text('message')

Verify before relying:

- Current Python version support: classifiers list 2.7, 3.3–3.6, but requires_python is unspecified and latest release is from 2018
- Whether repository activity since 2018 includes bug fixes or is maintenance-only

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 937.5K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

websocket client library, event-driven websocket, websocket connection streaming, python websocket events, ws wss client, websocket without threads, websocket event iteration, websocket-client, event-driven, networking

[View on SkillFed](https://skillfed.io/packages/lomond) · [View on PyPI](https://pypi.org/project/lomond/)