perceptive-client

Lookup image metadata locally using pHash index

Summary

This is a mediachain demo that -- given an image -- will look up its metadata as stored on IPFS. For the purposes of this demo, image reverse lookup is facilitated by an index calculated with the pHash perceptual hashing algorithm and published to a known IPNS address.

Requirements

All platforms

pip install -r requirements.txt

Mac OS X

brew install imagemagick phash

Install IPFS from source: https://github.com/ipfs/go-ipfs#build-from-source

Ubuntu

sudo apt-get install libmagickwand-dev imagemagick

Compile & install pHash from http://phash.org/download/

Install IPFS from source: https://github.com/ipfs/go-ipfs#build-from-source

Usage

usage: perceptive-client [-h] [-d DISTANCE] [-g IPFS_GATEWAY | -s IPFS_SERVER]
                         [-l LOCAL_INDEX]
                         image

Some usage notes:

When using the -s option, specify only the IPv4 address of the server. Furthermore, when using the -s option (recommended), you should run a local IPFS daemon with the command ipfs daemon.