triplet

module

v1.1.0 Latest Latest Go to latest Published: May 4, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/libops/triplet

Links

Open Source Insights

README ¶

triplet

A IIIF server in Go. Triplet implements the IIIF Image API 3.0 and IIIF Presentation API 3.0.

All image processing is done by libvips through govips.

Quick start

docker run -p 8080:8080 ghcr.io/libops/triplet:main

Then try the bundled sample image:

curl http://localhost:8080/iiif/3/sample.png/info.json

Documentation

The project documentation lives at https://libops.github.io/triplet.

Development

make build
make test

License

MIT. See LICENSE.

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
triplet command Command triplet runs the triplet IIIF server.	Command triplet runs the triplet IIIF server.
triplet-cache-cleanup command Command triplet-cache-cleanup performs explicit filesystem cache cleanup.	Command triplet-cache-cleanup performs explicit filesystem cache cleanup.
triplet-healthcheck command
internal
cache Package cache stores and retrieves bytes keyed by an opaque string.	Package cache stores and retrieves bytes keyed by an opaque string.
config Package config loads and validates the triplet YAML configuration.	Package config loads and validates the triplet YAML configuration.
cors Package cors applies a small allowlist-based CORS policy.	Package cors applies a small allowlist-based CORS policy.
iiif/image/v3/handler Package handler implements the IIIF Image API 3.0 HTTP surface.	Package handler implements the IIIF Image API 3.0 HTTP surface.
iiif/image/v3/parse Package parse decodes IIIF Image API 3.0 request URLs into structured form.	Package parse decodes IIIF Image API 3.0 request URLs into structured form.
iiif/image/v3/pipeline Package pipeline executes a parsed IIIF Image API request against a source image, writing the encoded derivative to an io.Writer.	Package pipeline executes a parsed IIIF Image API request against a source image, writing the encoded derivative to an io.Writer.
iiif/image/v3/schema
iiif/image/v3/types Package types defines the JSON-LD shapes returned by the Image API 3.0.	Package types defines the JSON-LD shapes returned by the Image API 3.0.
iiif/presentation/v3/handler
iiif/presentation/v3/store
iiif/presentation/v3/types Package types defines JSON-LD shapes for the implemented IIIF Presentation API 3.0 surface.	Package types defines JSON-LD shapes for the implemented IIIF Presentation API 3.0 surface.
iiif/presentation/v3/validate
metrics
observability Package observability wires structured logging and request middleware.	Package observability wires structured logging and request middleware.
redact Package redact provides small helpers for keeping sensitive request values out of logs and error strings.	Package redact provides small helpers for keeping sensitive request values out of logs and error strings.
server Package server composes the triplet HTTP surface from configured subcomponents.	Package server composes the triplet HTTP surface from configured subcomponents.
storage Package storage resolves IIIF identifiers to readable image bytes.	Package storage resolves IIIF identifiers to readable image bytes.
vips Package vips owns the libvips process lifecycle and exposes a small helper surface that the rest of triplet uses.	Package vips owns the libvips process lifecycle and exposes a small helper surface that the rest of triplet uses.