See our collection for all versions of ConvNeXt.

Run ConvNeXt with Keras 3: JAX, PyTorch, or TensorFlow

kerasformers/convnext_base_fb_in22k

Paper: A ConvNet for the 2020s (arXiv:2201.03545) · HF Papers

ConvNeXt modernizes a ResNet-style CNN with ViT-inspired design choices. Use as ImageNet classifier or 4-stage backbone.

For more details on the model, please go to the upstream model card.

Pure-Keras 3 conversion of timm/convnext_base.fb_in22k for kerasformers. One implementation runs unmodified on TensorFlow / Torch / JAX.

This is an image-classification / backbone checkpoint (ConvNeXtImageClassify / ConvNeXtModel).

✨ Quick start

import os
os.environ["KERAS_BACKEND"] = "torch"  # or "jax" / "tensorflow"

from PIL import Image
import numpy as np
from kerasformers.models.convnext import ConvNeXtImageClassify, ConvNeXtModel

model = ConvNeXtImageClassify.from_weights("kerasformers/convnext_base_fb_in22k")
backbone = ConvNeXtModel.from_weights(
    "kerasformers/convnext_base_fb_in22k", as_backbone=True
)

image = Image.open("your_image.jpg").convert("RGB")
image = image.resize((224, 224))
x = np.asarray(image, dtype="float32")[None]  # (1, H, W, 3)
print(model(x).shape)  # (1, num_classes)
feats = backbone(x)
print(len(feats), [tuple(f.shape) for f in feats])

Load any ConvNeXt variant the same way with from_weights("kerasformers/<variant>"):

Variant	Hub
`convnext_atto_d2_in1k`	`kerasformers/convnext_atto_d2_in1k`
`convnext_base_fb_in1k`	`kerasformers/convnext_base_fb_in1k`
`convnext_base_fb_in22k`	`kerasformers/convnext_base_fb_in22k`
`convnext_base_fb_in22k_ft_in1k`	`kerasformers/convnext_base_fb_in22k_ft_in1k`
`convnext_base_fb_in22k_ft_in1k_384`	`kerasformers/convnext_base_fb_in22k_ft_in1k_384`
`convnext_femto_d1_in1k`	`kerasformers/convnext_femto_d1_in1k`
`convnext_large_fb_in1k`	`kerasformers/convnext_large_fb_in1k`
`convnext_large_fb_in22k`	`kerasformers/convnext_large_fb_in22k`
`convnext_large_fb_in22k_ft_in1k`	`kerasformers/convnext_large_fb_in22k_ft_in1k`
`convnext_large_fb_in22k_ft_in1k_384`	`kerasformers/convnext_large_fb_in22k_ft_in1k_384`
`convnext_nano_d1h_in1k`	`kerasformers/convnext_nano_d1h_in1k`
`convnext_nano_in12k_ft_in1k`	`kerasformers/convnext_nano_in12k_ft_in1k`
`convnext_pico_d1_in1k`	`kerasformers/convnext_pico_d1_in1k`
`convnext_small_fb_in1k`	`kerasformers/convnext_small_fb_in1k`
`convnext_small_fb_in22k`	`kerasformers/convnext_small_fb_in22k`
`convnext_small_fb_in22k_ft_in1k`	`kerasformers/convnext_small_fb_in22k_ft_in1k`
`convnext_small_fb_in22k_ft_in1k_384`	`kerasformers/convnext_small_fb_in22k_ft_in1k_384`
`convnext_tiny_fb_in1k`	`kerasformers/convnext_tiny_fb_in1k`
`convnext_tiny_fb_in22k`	`kerasformers/convnext_tiny_fb_in22k`
`convnext_tiny_fb_in22k_ft_in1k`	`kerasformers/convnext_tiny_fb_in22k_ft_in1k`
`convnext_tiny_fb_in22k_ft_in1k_384`	`kerasformers/convnext_tiny_fb_in22k_ft_in1k_384`
`convnext_xlarge_fb_in22k`	`kerasformers/convnext_xlarge_fb_in22k`
`convnext_xlarge_fb_in22k_ft_in1k`	`kerasformers/convnext_xlarge_fb_in22k_ft_in1k`
`convnext_xlarge_fb_in22k_ft_in1k_384`	`kerasformers/convnext_xlarge_fb_in22k_ft_in1k_384`

Tips

Set KERAS_BACKEND before importing Keras / kerasformers.
ConvNeXtImageClassify returns class logits; ConvNeXtModel returns features (as_backbone=True for multi-scale stages).
See docs and Loading Weights.
Upstream / timm checkpoints: ConvNeXtImageClassify.from_weights("hf:timm/convnext_base.fb_in22k").