---
id: logbook
version: "1.10.1"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# Logbook — A logging replacement for Python

License: permissive · Maintenance: active · Downloads: 5.6M/mo

## What it is and what it does

Logbook is a logging library that provides an alternative to Python's built-in logging module. It aims to be easier to set up and configure while supporting both traditional command-line applications and web frameworks. The package is actively maintained, supports Python 3.9 through 3.15, and includes beta support for free-threading in newer Python versions.

The library is installed via wheels with broad platform coverage (macOS, Linux, Windows, and ARM architectures). It has a single runtime dependency on typing-extensions, keeping the dependency footprint minimal. The package is in the top 5000 by popularity and has been maintained since its initial release in 2010.

Use it for:

- Replace stdlib logging in web applications where simpler configuration and cleaner API are preferred.
- Set up logging for command-line tools that need straightforward handler and formatter setup.
- Configure multiple log handlers and formatters for development, testing, and production environments.
- Integrate logging into frameworks or libraries that need a lightweight, flexible logging backbone.
- Migrate existing logging code to a more maintainable approach without rewriting all log statements.

## Worth the install?

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

Logbook is a logging library that replaces Python's standard logging module with a simpler, more flexible API designed for both command-line and web applications.

Yes, with conditions. Logbook is actively maintained, has no known vulnerabilities, and offers a permissive BSD-3-Clause license. Install it if you prefer a simpler logging API than stdlib logging and are willing to adopt a different library. The medium install friction (compiled wheels) is not a barrier for most projects. Verify that its feature set and design philosophy align with your application's logging needs before committing to it in a large codebase.

## Install

pip install logbook
uv add logbook
poetry add logbook

## Installing Logbook

Before you install: Medium install friction due to compiled wheels across multiple platforms and Python versions (3.9–3.15). Active maintenance with a recent release (9 days old) and 1506 repository stars suggest reliable upkeep. Single runtime dependency (typing-extensions) keeps the dependency tree lean.

License in practice: BSD-3-Clause is permissive; you can use, modify, and distribute Logbook in commercial and private projects with minimal restrictions, provided you include the license notice.

Quickstart:

pip install logbook

import logbook

logger = logbook.Logger('My App')
logger.info('Hello, world!')

Verify before relying:

- Whether Logbook's API is genuinely simpler than stdlib logging in practice and what specific setup advantages it offers.
- How Logbook handles concurrent logging in high-throughput web applications compared to standard logging.
- Whether the free-threading beta support (Python 3.14+) is production-ready or still experimental.
- Adoption scale and real-world usage patterns beyond download statistics.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 5.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python logging replacement, structured logging library, web application logging, simple python logging, logging configuration, application event logging, log handler framework, logging, web-friendly

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