jazzband

django-pipeline: Bundle and Compress Django Static Assets

django-pipeline packages CSS and JavaScript assets for Django by combining and compressing files during static-file collection. It suits Django projects that want configured asset bundles, with optional template support and data-URI embedding.

View on GitHub Compare
Stars
1.5k
Forks
366
Stars, last 30 days
+2

Our take

Health score

36/100

How it is scored
Activity
31
Community
72
Issues
21
Pull requests
20

+2 stars in the last 30 days

  • More contributors than 78% of the projects we track

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

1,539

Forks

366

Change since Nov 15, 2026: 0 stars·0 forks

Overview

django-pipeline is a Python library that integrates with Django’s static-file workflow to package CSS and JavaScript. It can combine configured source files into output bundles and compress them when collectstatic runs, helping projects manage production assets.

It is intended for Django developers who want asset processing configured in their application rather than assembling bundles manually. The project also supports JavaScript templates and optional embedding of images and fonts as data URIs.

Key Features

  • Concatenates configured CSS files into output bundles.
  • Concatenates configured JavaScript files into output bundles.
  • Compresses assets using configured compressors.
  • Runs asset compilation as part of Django’s collectstatic workflow.
  • Provides template tags for including configured stylesheets and scripts.
  • Supports JavaScript templates.
  • Offers optional data-URI embedding for images and fonts.

Use Cases

  • Django teams can bundle and compress frontend assets as part of a production static-file deployment.
  • Developers maintaining sites with multiple CSS or JavaScript source files can define predictable output bundles in Django settings.
  • Projects that use JavaScript templates can integrate their handling with the asset pipeline.
  • Teams seeking optional image or font embedding can use data URIs as part of their asset packaging setup.

Getting Started

Install the package:

pip install django-pipeline

See the README and documentation for configuration and usage details.

Alternatives

  • django-compressor: django-compressor processes linked and inline assets into cacheable files, while django-pipeline focuses on configured bundles during static-file collection.
ProjectLanguageLicenseStarsStatus
django-pipelinePythonMIT1.5kNot checked yet
django-compressorPython–2.9kMaintained

Considerations

  • The README says Pipeline only works when DEBUG is False.
  • Compilers and compressors must be installed separately and configured; the README demonstrates using a binary from a project’s node_modules directory.
  • Setup involves Django static-files finders, storage, and project-specific bundle configuration, so it is not a standalone asset bundler.

Found this useful?

Share it with someone who would like django-pipeline.

Comparisons