# clojure-liberator/liberator

Liberator is a Clojure library for building RESTful applications.

Repository: https://github.com/clojure-liberator/liberator
Canonical: https://ross.abutalabs.com/products/liberator
Homepage: http://clojure-liberator.github.io/liberator
Language: Clojure
License: NOASSERTION
License Family: other
Topics: clojure, http, rest, server-side
Last push: 2021-09-28T13:08:50+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 5113, "days_push": 1800, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1261, forks 126 (observed 2026-08-28T04:04:10.211523+00:00)

## What it is
Liberator is a Clojure library for building RESTful applications by defining resources that automatically comply with the HTTP specification (RFC-2616). It provides Ring-compatible handlers with built-in features like content negotiation, conditional requests, and caching, inspired by Erlang's Webmachine.

## Use cases
- build restful apis in clojure
- expose data as http resources with correct status codes
- add content negotiation to ring handlers
- implement conditional requests and etag caching
- create http-compliant web services on the jvm

## When to choose
- you're building REST APIs in Clojure on top of Ring
- you want automatic HTTP spec compliance including caching and content negotiation
- you prefer a declarative, decision-graph model for resource handling

## When to avoid
- you need a full web framework with routing and templating built in
- you're not using Clojure or the JVM
- you need a library under very active development, as releases have slowed since 2021

## Facets
- artifact type: library
- maturity: maintenance
- function: web-framework, http-server, middleware
- domain: web-development, backend, apis
- platform: jvm, jvm-scripting
- tags: rest, ring, http-spec-compliance, content-negotiation, webmachine-inspired, web-server

## Member repositories
- clojure-liberator/liberator (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:10.211523+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-30T05:04:18.147176+00:00, confidence not recorded.
  - readme: https://github.com/clojure-liberator/liberator (fetched 2026-08-28T04:04:10.211523+00:00, sha 0b4603d2c5bc)
  - homepage: http://clojure-liberator.github.io/liberator (fetched 2026-08-29T12:16:30.854318+00:00, sha f142893b9330)
- Data as of 2026-08-30T08:39:29.467469+00:00.
