narwhals
PyPIv2.26.0Extremely lightweight compatibility layer between dataframe libraries
Not recommended for new projects
No — narwhals should not be adopted for new projects. No license declared — you have no explicit right to use this code.
- ?Adoption: grade ?, Not reported by this registry.
No download data reported for this package yet.
- AMaintenance: grade A, Excellent.
Last published 1 days ago. 50 releases in the last 2 years.
- AWeight: grade A, Excellent.
Zero runtime dependencies, about 463 KB installed.
- BSupply chain: grade B, Good.
This package has a single maintainer (bus factor of 1).
- FLicense: grade F, Failing.
No license declared — you have no explicit right to use this code.
Grades are computed deterministically from registry metadata collected by PackageGraph — downloads, dependents, publish dates, the resolved dependency tree, maintainer count, and declared licenses. No third-party scores are used.
Install cost
What you actually take on by adding narwhals to a project.
Runtime packages this one declares itself.
Distinct packages in the full runtime tree, deduplicated the way a package manager would.
Unpacked size of this package plus its entire runtime tree.
Longest resolved dependency chain below this package.
Compatibility
- Python
- python >=3.10
Quick start
A usage example from the narwhals README.
import narwhals as nw
from narwhals.typing import IntoFrameT
def agnostic_function(df_native: IntoFrameT) -> IntoFrameT:
return (
nw.from_native(df_native)
.with_columns(
category=nw.when(nw.col("animal").str.contains("whale"))
.then(nw.lit("whale"))
.otherwise(nw.lit("other"))
)
.to_native()
)Used by
Popular packages that depend on narwhals.
Relationship graph
Dependencies (left) and dependents (right) of narwhals.
Frequently installed together
Release history
50 releases in the last two years, typically about 15 days apart.
| Version | Published | Size | License |
|---|---|---|---|
| 2.26.0latest | 1 day ago | 463 KB | — |
| 2.25.0 | 20 days ago | 456 KB | — |
| 2.24.0 | 1 month ago | 450 KB | — |
| 2.23.0 | 2 months ago | 448 KB | — |
| 2.22.1 | 3 months ago | 444 KB | — |
| 2.22.0 | 3 months ago | 443 KB | — |
| 2.21.2 | 3 months ago | 441 KB | — |
| 2.21.0 | 4 months ago | 441 KB | — |
| 2.20.0 | 4 months ago | 439 KB | — |
| 2.19.0 | 5 months ago | 437 KB | — |
| 2.18.1 | 5 months ago | 435 KB | — |
| 2.18.0 | 6 months ago | 434 KB | — |
| 2.17.0 | 6 months ago | 434 KB | — |
| 2.16.0 | 7 months ago | 434 KB | — |
| 2.15.0 | 8 months ago | 423 KB | — |
Overview
narwhals is an PyPI package that extremely lightweight compatibility layer between dataframe libraries. It has 1 known dependents in the graph. The latest version is 2.26.0.
Who should use it
Teams working in the PyPI ecosystem who need extremely lightweight compatibility layer between dataframe libraries and value a focused solution.
When not to use it
Consider an alternative if you need to or if a more actively-maintained option better fits your PyPI stack.
Pros
- Zero runtime dependencies — minimal footprint.
Cons
- No license detected — review usage terms before adopting.
Auto-generated from collected registry metadata. No external claims are inferred.
Maintainers
Frequently asked questions
Should I use narwhals?
No — narwhals should not be adopted for new projects. No license declared — you have no explicit right to use this code.
How do I install narwhals?
Run `pip install narwhals` to add narwhals to your PyPI project.
What license is narwhals released under?
No license was detected in narwhals's metadata; review the repository before use.
How popular is narwhals?
PyPI does not publish download counts. Within PackageGraph's crawl, 1 known packages depend on narwhals.
Is narwhals still maintained?
The most recent release of narwhals (v2.26.0) was published 1 day ago.