---
id: awkward-pandas
version: "2023.8.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# awkward-pandas — Awkward Array Pandas Extension

License: permissive · Maintenance: aging · Downloads: 363.8K/mo

## What it is and what it does

awkward-pandas is a pandas extension that allows you to store Awkward Array objects as columns in DataFrames. Awkward Array is a library for working with nested, ragged, and complex data structures efficiently—the kind of data that doesn't fit neatly into a rectangular table. This extension bridges the two libraries, letting you use pandas' familiar API and tools while leveraging Awkward Array's capabilities for handling irregular data.

The package is in alpha status and has not seen a release since August 2023, though the repository remains active. It supports Python 3.8 through 3.11 and depends on both awkward and pandas. Use it when you need to work with nested or ragged data but want to stay within the pandas ecosystem rather than switching entirely to Awkward Array.

Use it for:

- Store lists of varying lengths as DataFrame columns without flattening or padding the data.
- Work with hierarchical or nested JSON-like data structures directly in pandas operations.
- Combine ragged array data with tabular data in a single DataFrame for analysis.
- Leverage pandas' groupby and aggregation operations on data containing nested arrays.

## Worth the install?

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

Extends pandas DataFrames to store and manipulate Awkward Array columns, enabling efficient handling of nested and ragged data structures within pandas workflows.

Yes, if you need to work with nested or ragged data in pandas. The low install friction, permissive license, and lack of known vulnerabilities make it safe to try. However, the aging maintenance status (no release in over a year) means you should verify compatibility with your specific pandas and Python versions before relying on it in production.

## Install

pip install awkward-pandas
uv add awkward-pandas
poetry add awkward-pandas

## Installing awkward-pandas

Before you install: Low install friction with a pure-Python wheel. Maintenance is aging—last release was over a year ago (2023-08-08) and the last commit is recent (2025-09-17), suggesting the project is maintained but not actively developed. Depends on awkward and pandas, both mature libraries.

License in practice: BSD License (permissive) allows use in commercial and private projects with minimal restrictions, requiring only license attribution.

Quickstart:

pip install awkward-pandas
import pandas as pd
import awkward_pandas
df = pd.DataFrame({'col': []})
df['col'] = df['col'].astype('awkward')

Requires pandas and awkward as runtime dependencies; Python >= 3.8.

Verify before relying:

- Whether the aging maintenance status (1102 days since release) affects compatibility with recent pandas versions.
- Performance characteristics when working with very large nested datasets compared to alternative approaches.
- Real-world usage patterns and adoption beyond the 52 GitHub stars.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 363.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pandas awkward array extension, nested data in pandas, ragged arrays pandas, awkward array pandas integration, complex nested structures dataframe, pandas columnar extension, pandas-extension, nested-data, data-structures

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