Welcome to Milvus

Firstly, welcome, and thanks for your interest in Milvus! No matter who you are, what you do, we greatly appreciate your contribution to help us reinvent data science with Milvus.

What is Milvus

Milvus is an open source vector search engine that supports similarity search of large-scale vectors. Built on optimized indexing algorithm, it is compatible with major AI/ML models.

Milvus provides stable Python, C++ and Java APIs.

Keep up-to-date with newest releases and latest updates by reading Milvus release notes.

GPU-accelerated search engine

Milvus is designed for the largest scale of vector index. CPU/GPU heterogeneous computing architecture allows you to process data at a speed 1000 times faster.
Intelligent index

With a "Decide Your Own Algorithm" approach, you can embed machine learning and advanced algorithms into Milvus without the headache of complex data engineering or migrating data between disparate systems. Milvus is built on optimized indexing algorithm based on quantization indexing, tree-based and graph indexing methods.
Strong scalability

The data is stored and computed on a distributed architecture. This lets you scale data sizes up and down without redesigning the system.

Architecture

Get started

Install using docker

Use Docker to install Milvus is a breeze. See the Milvus install guide for details.

Build from source

Software requirements

Ubuntu 18.04 or higher
CMake 3.14 or higher
CUDA 10.0 or higher
NVIDIA driver 418 or higher

Compilation

Step 1 Install dependencies

$ cd [Milvus sourcecode path]/core
./ubuntu_build_deps.sh

Step 2 Build

$ cd [Milvus sourcecode path]/core
$ ./build.sh -t Debug
or 
$ ./build.sh -t Release

When the build is completed, all the stuff that you need in order to run Milvus will be installed under [Milvus root path]/core/milvus.

Launch Milvus server

$ cd [Milvus root path]/core/milvus

Add lib/ directory to LD_LIBRARY_PATH

$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/milvus/lib

Then start Milvus server:

$ cd scripts
$ ./start_server.sh

To stop Milvus server, run:

$ ./stop_server.sh

To edit Milvus settings in conf/server_config.yaml and conf/log_config.conf, please read Milvus Configuration.

Try your first Milvus program

Run Python example code

Make sure Python 3.4 or higher is already installed and in use.

Install Milvus Python SDK.

# Install Milvus Python SDK
$ pip install pymilvus==0.2.0

Create a new file example.py, and add Python example code to it.

Run the example code.

# Run Milvus Python example
$ python3 example.py

Run C++ example code

 # Run Milvus C++ example
 $ cd [Milvus root path]/core/milvus/bin
 $ ./sdk_simple

Run Java example code

Make sure Java 8 or higher is already installed.

Refer to this link for the example code.

Contribution guidelines

Contributions are welcomed and greatly appreciated. If you want to contribute to Milvus, please read our contribution guidelines. This project adheres to the code of conduct of Milvus. By participating, you are expected to uphold this code.

We use GitHub issues to track issues and bugs. For general questions and public discussions, please join our community.