---
id: twiggy
version: "0.5.1"
license: BSD
license_treatment: permissive
maintenance: abandoned
---

# Twiggy — a Pythonic logger

License: permissive · Maintenance: abandoned · Downloads: 167.6K/mo

## What it is and what it does

Twiggy is a structured logging library designed to make logging more Pythonic by supporting method chaining, named fields, and a fluent API. Instead of formatting log messages as strings upfront, you attach structured data (fields) to log entries and let the logger handle output formatting. It provides a quick-setup entry point for simple use and a more flexible configuration path for advanced scenarios.

The package depends only on six for Python 2/3 compatibility. It has been stable since its early releases and is classified as Production/Stable, but development stopped in 2021. The library is lightweight and installs with minimal friction, making it suitable for projects that value clean logging syntax but must accept the trade-off of no ongoing maintenance.

Use it for:

- Add structured fields (like request IDs or user names) to log entries without manual string formatting.
- Build readable log output by chaining method calls (e.g., log.name('module').fields(x=1).info('message')).
- Replace Python's standard logging in small to medium projects where a simpler, more Pythonic API is preferred.
- Emit logs with consistent, machine-parseable structure for downstream analysis or aggregation.

## Worth the install?

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

Twiggy is a structured logging library that provides a Pythonic API for emitting log messages with named fields, formatting, and chaining.

Yes, if you are starting a new project and value a clean, Pythonic logging API and can accept that the package is no longer maintained. No, if you need active bug fixes, security updates, or compatibility with the latest Python versions—consider modern alternatives like structlog or loguru instead. The low install friction and permissive license make it a low-risk experiment for small codebases.

## Install

pip install twiggy
uv add twiggy
poetry add twiggy

## Installing Twiggy

Before you install: Installation is frictionless (pure Python wheel, single dependency on six). However, the package is abandoned—last commit was 2021-09-08, over four years ago, with no active maintenance. Use only if you accept the risk of unpatched issues.

License in practice: Licensed under BSD (permissive), so you can use, modify, and distribute Twiggy freely in commercial and open-source projects without significant legal restrictions.

Quickstart:

pip install twiggy

from twiggy import quick_setup, log
quick_setup()
log.name('frank').fields(number=42).info('hello {who}', who='world')

Verify before relying:

- Whether Twiggy's API and output format remain compatible with modern Python logging ecosystems and third-party integrations.
- Current test coverage and whether the codebase runs without warnings on Python 3.10+.

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 167.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python structured logging, pythonic logger library, log with named fields, chained logging api, formatted log messages, python logging alternative, field-based logging, structured-logging, abandoned-but-stable

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