README.md

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
• Install
• Quick Start
• Architecture diagram
• Phantoscope Basics
• Tutorial
• API reference
• Contributing
• Community
• Roadmap
• License

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

2. 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)

3. Start up Phantoscope containers:

$ docker-compose up -d

4. 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

• What is operator?
• What is pipeline?
• What is application?

Tutorial

• Try out Phantoscope Preview
• Create an application
• Develop an operator

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

• Try our Slack Channel, if you run into issues and want to consult our experts.

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