Skip to content
This repository has been archived by the owner on Sep 28, 2021. It is now read-only.

zilliztech/phantoscope

Repository files navigation

CI GitHub GitHub top language GitHub commit activity GitHub release (latest by date including pre-releases) Language grade: Python codecov

Phantoscope is an image search suite powered by Milvus and neutral networks.

Extremely high speed in processing and searching billions of images.

Compatible with Tensorflow, Pytorch, TensorRT, ONNX, XGBoost, and more.

Provides GUI for demonstrating search results and managing Phantoscope data.

Soon to establish an extension market, where you can share your extension with the world.

Native support for Docker and Kubernetes.

English | 中文版

Table of Contents

Background

Your search should not be confined to key words and short sentences.

With the explosion of images and video data in human society, the legacy text search can hardly serve people's needs.

For example, an image involves a myriad of information, and different people have different interpretation of the same image. The existing search engines, be it full-text search or searching image by image, can no longer meet such flexible multi-dimensional search requirements.

Phantoscope is the right tool for you. Empowered by miscellaneous deep-learning models, portable image processing techniques, and Milvus vector search engine, it can offer a unique set of high-performance image searching interfaces to address such needs.

Install

  1. Download Phantoscope:
$ git clone https://github.com/zilliztech/phantoscope.git -b 0.2.0 && cd phantoscope
  1. Set up the environment:
$ export LOCAL_ADDRESS=$(ip a | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1'| head -n 1)
  1. Start up Phantoscope containers:
$ docker-compose up -d
  1. Check the status of all containers:
$ docker-compose ps

You are expected to see the following output:

Name                   Command                          State   Ports
----------------------------------------------------------------------------------------------------------------
phantoscope_api_1      /usr/bin/gunicorn3 -w 4 -b ...   Up      0.0.0.0:5000->5000/tcp                            
phantoscope_milvus_1   /var/lib/milvus/docker-ent ...   Up      0.0.0.0:19121->19121/tcp, 0.0.0.0:19530->19530/tcp
phantoscope_minio_1    /usr/bin/docker-entrypoint ...   Up      0.0.0.0:9000->9000/tcp                            
phantoscope_mongo_1    docker-entrypoint.sh mongod      Up      0.0.0.0:27017->27017/tcp

Quick Start

Click here to set up a basic Phantoscope application. You can use it to upload and search images.

Architecture diagram

Phantoscope basics

Tutorial

Tutorial

API reference

Click here to read our latest RESTful API reference.

Contributing

Contributions are welcomed and greatly appreciated.

Please read our contribution guidelines for detailed contribution workflow.

We use GitHub issues to track issues and bugs.

For general questions and public discussions, please join our community.

Community

Roadmap

GitHub milestones lays out the development plan for Phantoscope.

We hope you could team up with us in the development of Phantoscope.

License

Apache License 2.0