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
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
Metadata Files
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
- Docker is installed
- Optionally, Python 3.9 or higher is installed
- 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
- Website: https://clowderframework.org/
- Repositories: 30
- Profile: https://github.com/clowder-framework
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
Pull Request Labels
Dependencies
- python 3.9-slim build
- 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