zeo

library6.2pypypi✓ verified 83d ago

ZEO (Zope Enterprise Objects) provides a client-server storage for ZODB (Zope Object Database). Version 6.2 supports Python >=3.10. Allows multiple processes to share a single ZODB database over a network. ZEO is stable with periodic releases.

database

pip install zeo

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · ZEO

zeo

databasepythonv6.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ZEO.ClientStorage

✓ from ZEO import ClientStorage

✗ from zeo import ClientStorage

The package is 'ZEO' (uppercase), not 'zeo'. Python packages are case-sensitive on most systems.

Connects to a ZEO server running on localhost:8100, stores a simple object in the root of the database.

import ZEO from ZEO import ClientStorage import ZODB from ZODB import DB addr = ('localhost', 8100) storage = ClientStorage.ClientStorage(addr) db = DB(storage) with db.transaction() as conn: root = conn.root() root['hello'] = 'world' conn.commit() db.close()

runzeo --version

Debug

Known issues

breakingPython 3.10+ required. ZEO 6.x drops support for Python 2.7, 3.5, 3.6, 3.7, 3.8, 3.9. If you are on an older Python version, you must use ZEO 5.x or lower.

fix

Ensure Python >=3.10 is used.

affects: >=6.0

deprecatedZEO's storages based on FileStorage and zeopack are deprecated. The recommended storage is a RelStorage-backed ZEO server with a PostgreSQL or MySQL backend.

fix

Migrate to RelStorage for production deployments.

affects: >=6.0

gotchaThe ZEO server (runzeo) must be running before the client connects. Common mistake: starting the client first results in a ConnectionRefusedError.

fix

Start the ZEO server before any client. Use: runzeo -a 8100 -f data.fs

affects: all

gotchaZEO is not thread-safe by default. The client storage must be used in a single-threaded manner or with proper locking. Multi-threaded access requires wrapper storages.

fix

Use ZODB's DB with a thread-safe storage or serialize access.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'ZEO'

Installed 'zeo' (lowercase) but not 'ZEO' (uppercase). The Python package is 'ZEO' with capital letters.

fix

Install the correct package: pip install ZEO (note: the package on PyPI is lowercase 'zeo', but the Python module is 'ZEO'. The pip package name is case-insensitive, so 'pip install zeo' works, but import uses 'ZEO').

ImportError: cannot import name 'ClientStorage' from 'ZEO'

Possibly missing dependency or incorrect import. Ensure you have the correct version installed.

fix

Install ZEO: pip install zeo. Then try: from ZEO import ClientStorage

ConnectionRefusedError: [Errno 111] Connection refused

The ZEO server is not running or not reachable at the specified address.

fix

Start the ZEO server: runzeo -a 8100 -f data.fs. Ensure the address and port match.

Upgrade

Version history

6.2latest on PyPI · released Apr 13, 2026

Audit

Dependencies

ZODBoptionalZEO is a storage backend for ZODB.

zope.interfacerequiredRequired for interfaces.

Agent activity

31 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/zopefoundation/ZEO ↗

packagehttps://pypi.org/project/zeo/ ↗

docshttps://zeo.readthedocs.io/ ↗

changeloghttps://raw.githubusercontent.com/zopefoundation/ZEO/master/CHANGES.rst ↗