# y-scope/clp

Compressed Log Processor (CLP) is a free log management tool capable of compressing logs and searching the compressed logs without decompression.

Repository: https://github.com/y-scope/clp
Canonical: https://ross.abutalabs.com/products/clp
Homepage: https://yscope.com
Language: C++
License: Apache-2.0
License Family: permissive
Topics: logging, compression, analytics, search, log-parser, log-management
Last push: 2026-08-31T20:33:58+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 82, longevity 100
- inputs: {"age_days": 1920, "days_push": 2, "days_rel": 42, "gap_med": 39.0, "n_releases_24m": 15}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1083, forks 92 (observed 2026-09-01T02:14:08.542296+00:00)

## What it is
CLP (Compressed Log Processor) is an open-source log management tool that losslessly compresses JSON and unstructured text logs and enables searching and analytics directly on the compressed data without decompression. It provides an end-to-end pipeline including logging libraries for real-time compression, a web UI for search and viewing, and deployment options from single-node Docker to Kubernetes.

## Use cases
- compress large log files without losing data
- search compressed logs without decompressing them
- self-hosted log management alternative to Elasticsearch or Splunk
- real-time log compression from Python or Java logging libraries
- reduce cloud storage costs for petabyte-scale log retention
- analyze and view JSON logs with a web interface
- archive vehicle or edge device logs locally before upload

## When to choose
- you need extremely high compression ratios (up to ~169x) on structured or free-text logs
- you want to search logs without paying the decompression or indexing overhead of Elasticsearch or Splunk
- you prefer a self-hosted, schema-free log pipeline with Docker/Kubernetes deployment
- you need real-time compression integrated into existing logging libraries

## When to avoid
- you need a fully managed SaaS log platform with alerting and dashboards out of the box
- your logs are small enough that standard tools like grep or gzip suffice
- you rely on ecosystem features like built-in metrics, tracing, or extensive third-party integrations
- you require non-Linux production environments, as CLP targets Linux-based deployments

## Facets
- artifact type: application
- maturity: active
- function: compression, search-engine, logging, analytics, web-scraping
- domain: databases, analytics, big-data
- platform: self-hosted, cloud, python, cpp
- tags: log-management, log-compression, search-without-decompression, json-logs, unstructured-logs, log-viewer, mcp-server, presto, search, devops, linux, macos, docker, kubernetes, web-server

## Member repositories
- y-scope/clp (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-09-01T02:14:08.542296+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:51:12.794898+00:00, confidence not recorded.
  - readme: https://github.com/y-scope/clp (fetched 2026-09-01T02:14:08.542296+00:00, sha bc5417b58d01)
  - homepage: https://yscope.com (fetched 2026-08-29T12:53:16.816974+00:00, sha 274d2872c5e8)
  - site_page: https://docs.yscope.com/ (fetched 2026-08-29T12:53:16.825766+00:00, sha badb6d7dd75d)
  - site_page: https://yscope.com/about-us (fetched 2026-08-29T12:53:16.832003+00:00, sha 30f470b866a7)
  - site_page: https://yscope.com/legal/privacyfaq (fetched 2026-08-29T12:53:16.827490+00:00, sha 5c0911913186)
- Data as of 2026-08-30T08:39:29.467469+00:00.