https://github.com/clowder-framework/iiif-presentation-api-server

This is an implementation of the International Image Interoperability Framework (IIIF) Presentation API V3

https://github.com/clowder-framework/iiif-presentation-api-server

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.5%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

This is an implementation of the International Image Interoperability Framework (IIIF) Presentation API V3

Basic Info
  • Host: GitHub
  • Owner: clowder-framework
  • Language: Python
  • Default Branch: main
  • Size: 6.84 KB
Statistics
  • Stars: 0
  • Watchers: 2
  • Forks: 0
  • Open Issues: 1
  • Releases: 0
Created over 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme

README.md

International Image Interoperability Framework (IIIF) Presentation API V3 Server

This is a simple server that generates IIIF Presentation API V3 manifests for images hosted on an IIIF Image API V3 server. For more details on the IIIF Presentation API V3, please refer to the official documentation.

Pre-requisites

  1. Docker is installed
  2. Optionally, Python 3.9 or higher is installed
  3. An IIIF Image API V3 server is running. The current implementation has been tested with Cantaloupe.

Docker-based Instructions (Recommended)

Build the image

bash docker build -t iiif-presentation-api-server .

Run the container

```bash

This assumes that an IIIF Image API V3 server is running on the host machine at port 8182

docker run -p 8002:8000 --env IIIFIMAGEAPISERVERURL=http://host.docker.internal:8182/iiif/3 iiif-presentation-api-server ```

API Documentation

After starting the server, the API documentation will be available at http://localhost:8002/docs.

Usage

Get manifest for a given image

This assumes that a file with name CATS_MM14_C_F1_XPL-big.tif is available in the IIIF Image API server.

bash curl -X 'GET' \ 'http://localhost:8002/api/v1/manifests/CATS_MM14_C_F1_XPL-big.tif/manifest.json' \ -H 'accept: application/json'

Health check

bash curl -X 'GET' \ 'http://localhost:8002/api/v1/ok' \ -H 'accept: application/json'

Local Installation Instructions (Alternative)

Create virtual environment

bash python3 -m venv venv source venv/bin/activate pip install --upgrade pip pip install -r requirements.txt

Run the server

bash export PYTHONPATH=$PWD/app python -m uvicorn app.main:app --reload --port 8002

Owner

  • Name: Clowder
  • Login: clowder-framework
  • Kind: organization
  • Email: clowder@lists.illinois.edu

Research data management for long tail data.

GitHub Events

Total
  • Issues event: 1
  • Member event: 1
  • Push event: 4
  • Create event: 2
Last Year
  • Issues event: 1
  • Member event: 1
  • Push event: 4
  • Create event: 2

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 1
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • sandeep-ps (1)
Pull Request Authors
Top Labels
Issue Labels
bug (1)
Pull Request Labels

Dependencies

Dockerfile docker
  • python 3.9-slim build
requirements.txt pypi
  • annotated-types ==0.7.0
  • anyio ==4.7.0
  • certifi ==2024.12.14
  • charset-normalizer ==3.4.0
  • click ==8.1.7
  • exceptiongroup ==1.2.2
  • fastapi ==0.115.6
  • h11 ==0.14.0
  • idna ==3.10
  • iiif-prezi3 ==2.0.0
  • pillow ==11.0.0
  • pydantic ==1.10.19
  • pydantic_core ==2.27.2
  • requests ==2.32.3
  • sniffio ==1.3.1
  • starlette ==0.41.3
  • typing_extensions ==4.12.2
  • urllib3 ==2.2.3
  • uvicorn ==0.34.0