https://github.com/internetarchive/iiif
The official Internet Archive IIIF service
https://github.com/internetarchive/iiif
hacktoberfest
Last synced: 8 months ago
JSON representation
The official Internet Archive IIIF service
- Host: GitHub
- URL: https://github.com/internetarchive/iiif
- Owner: internetarchive
- License: gpl-3.0
- Created: 2023-08-11T20:49:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-01T12:44:27.000Z (9 months ago)
- Last Synced: 2025-05-01T13:20:05.457Z (9 months ago)
- Topics: hacktoberfest
- Language: JavaScript
- Homepage:
- Size: 83.1 MB
- Stars: 23
- Watchers: 20
- Forks: 5
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- License: LICENSE
Awesome Lists containing this project
README
# iiif.archive.org
The Internet Archive's official [IIIF 3.0 Image & Presentation API](https://iiif.io) service.
## Background
This service replaces the iiif.archivelab.org unofficial labs API.
## Technical Details
The service uses a manifest/API service written in python3 flask and makes image processing calls to cantaloupe in both iiif 3.0 and 2.0 format.
## Installation & Setup
```
git clone https://github.com/internetarchive/iiif.git
cd iiif
pip install .
python app.py
```
Navigate to http://127.0.0.1:8080/iiif
You can also run the app using Docker, either with the Flask development server:
```
docker build -t iiify .
docker run -d --rm --name iiify -p 8080:8080 iiify
```
or with an image using nginx and uwsgi:
```
docker build -t iiify-uwsgi -f Dockerfile-uwsgi .
docker run -d --rm --name iiify -p 8080:8080 iiify-uwsgi
```
Navigate to http://127.0.0.1:8080/iiif
## Testing
Unit tests are in the `tests` folder and can be run with:
```
python -m unittest discover -s tests
```
Run single test:
```
python -m unittest tests.test_video.TestVideo.test_vtt_autogenerated
```
Retrieve large.jpg as 800px wide JPEG
* http://127.0.0.1:8080/iiif/large.jpg/full/800,/0/default.jpg
Crop into large.jpg and return 800px wide JPEG
* http://127.0.0.1:8080/iiif/large.jpg/full/800,/0/default.jpg
Mirror large.jpg horizontally and return 800px wide JPEG
* http://127.0.0.1:8080/iiif/large.jpg/full/800,/!0/default.jpg