threaddao / pymilvus

Python SDK for Milvus.

Milvus Python SDK

Python SDK for Milvus. To contribute code to this project, please read our contribution guidelines first. If you have some ideas or encounter a problem, you can find us in the Slack channel #py-milvus.

Compatibility

The following collection shows Milvus versions and recommended PyMilvus versions:

Milvus version	Recommended PyMilvus version
1.0.*	1.0.1
1.1.*	1.1.2
2.0.0-RC7	2.0.0rc7
2.0.0-RC8	2.0.0rc8

Installation

You can install PyMilvus via pip or pip3 for Python 3.6+:

$ pip3 install pymilvus

You can install a specific version of PyMilvus by:

$ pip3 install pymilvus==2.0.0rc8

You can upgrade PyMilvus to the latest version by:

$ pip3 install --upgrade pymilvus

Documentation

Documentation is available online: https://milvus.io/api-reference/pymilvus/v2.0.0rc8/install.html.

Packages

Released packages

The release of PyMilvus is managed on GitHub, and GitHub Actions will package and upload each version to PyPI.

The release version number of PyMilvus follows PEP440, the format is x.y.z, and the corresponding git tag name is vx.y.z (x/y/z are numbers from 0 to 9).

For example, after PyMilvus 1.0.1 is released, a tag named v1.0.1 can be found on GitHub, and a package with version 1.0.1 can be downloaded on PyPI.

Developing packages

The commits on the development branch of each version will be packaged and uploaded to Test PyPI. Development branches refer to branches such as 1.0 and 1.1, and version releases are generated from the development branches, such as 1.0.1 and 1.0.2.

The package name generated by the development branch is x.y.z.dev, where is the number of commits that differ from the most recent release.

For example, after the release of 1.0.1, two commits were submitted on the 1.0 branch. At this time, the automatic packaging version number of the development branch is 1.0.1.dev2.

To install the package on test.pypi.org, you need to append the parameter --index-url after pip, for example:

$ python3 -m pip install --index-url https://test.pypi.org/simple/ pymilvus

License

Apache License 2.0