# Milvus Python SDK
[![version](https://img.shields.io/pypi/v/pymilvus.svg?color=blue)](https://pypi.org/project/pymilvus/)
[![Supported Python Versions](https://img.shields.io/pypi/pyversions/pymilvus?logo=python&logoColor=blue)](https://pypi.org/project/pymilvus/)
[![Downloads](https://static.pepy.tech/badge/pymilvus)](https://pepy.tech/project/pymilvus)
[![Downloads](https://static.pepy.tech/badge/pymilvus/month)](https://pepy.tech/project/pymilvus)
[![Downloads](https://static.pepy.tech/badge/pymilvus/week)](https://pepy.tech/project/pymilvus)
[![license](https://img.shields.io/hexpm/l/plug.svg?color=green)](https://github.com/milvus-io/pymilvus/blob/master/LICENSE)
[![Mergify Status][mergify-status]][mergify]
![Static Badge](https://img.shields.io/badge/slack-%23py--milvus-blue?style=social&logo=slack&link=https%3A%2F%2Fmilvusio.slack.com%2Farchives%2FC024XTWMT4L)
[mergify]: https://mergify.com
[mergify-status]: https://img.shields.io/endpoint.svg?url=https://api.mergify.com/v1/badges/milvus-io/pymilvus&style=flat
Python SDK for [Milvus](https://github.com/milvus-io/milvus). To contribute code to this project, please read our [contribution guidelines](https://github.com/milvus-io/milvus/blob/master/CONTRIBUTING.md) first. If you have some ideas or encounter a problem, you can find us in the Slack channel [#py-milvus](https://milvusio.slack.com/archives/C024XTWMT4L).
## 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.\* | 2.0.2 |
| 2.1.\* | 2.1.3 |
| 2.2.\* | 2.2.15 |
| 2.3.\* | 2.3.7 |
| 2.4.\* | 2.4.0 |
## Installation
You can install PyMilvus via `pip` or `pip3` for Python 3.8+:
```shell
$ pip3 install pymilvus
$ pip3 install pymilvus[model] # for milvus-model
$ pip3 install pymilvus[bulk_writer] # for bulk_writer
```
You can install a specific version of PyMilvus by:
```shell
$ pip3 install pymilvus==2.3.7
```
You can upgrade PyMilvus to the latest version by:
```shell
$ pip3 install --upgrade pymilvus
```
## FAQ
Q1. How to get submodules?
A1. The following command will get the protos matching to the generated files, for protos of certain version, see
[milvus-proto](https://github.com/milvus-io/milvus-proto#usage) for details.
```shell
$ git submodule update --init
```
Q2. How to generate python files from milvus-proto?
A2.
```shell
$ make gen_proto
```
Q3. How to use the local PyMilvus repository for Milvus server?
A3.
```shell
$ make install
```
Q4. How to check coding styles?
A4.
```shell
make lint
```
Q5. How to fix the coding styles?
A5
```shell
make format
```
Q6. How to run unittests?
A6
```shell
$ pip install ".[dev]"
$ make unittest
```
Q7. `zsh: no matches found: pymilvus[model]`, how do I solve this?
A7
```shell
$ pip install "pymilvus[model]"
```
## Documentation
Documentation is available online: https://milvus.io/api-reference/pymilvus/v2.4.x/About.md
## Developing package releases
The commits on the development branch of each version will be packaged and uploaded to [Test PyPI](https://test.pypi.org/).
The package name generated by the development branch is x.y.z.rc<dist>, where <dist> is the number of commits that differ from the most recent release.
- For example, after the release of **2.3.4**, two commits were submitted on the 2.3 branch.
The version number of the latest commit of 2.3 branch is **2.3.5.rc2**.
- For example, after the release of **2.3.4**, 10 commits were submitted on the master branch.
The version number of the latest commit of master branch is **2.4.0.rc10**.
To install the package on Test PyPi, you need to append `--extra-index-url` after pip, for example:
```shell
$ python3 -m pip install --extra-index-url https://test.pypi.org/simple/ pymilvus==2.1.0.dev66
```
## License
[Apache License 2.0](LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "pymilvus",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Milvus Team <milvus-team@zilliz.com>",
"download_url": "https://files.pythonhosted.org/packages/a5/3e/610e462640038807f1d17abc39e8e14e3f0551fe592345bc1c570fb35c51/pymilvus-2.4.3.tar.gz",
"platform": null,
"description": "# Milvus Python SDK\n\n[![version](https://img.shields.io/pypi/v/pymilvus.svg?color=blue)](https://pypi.org/project/pymilvus/)\n[![Supported Python Versions](https://img.shields.io/pypi/pyversions/pymilvus?logo=python&logoColor=blue)](https://pypi.org/project/pymilvus/)\n[![Downloads](https://static.pepy.tech/badge/pymilvus)](https://pepy.tech/project/pymilvus)\n[![Downloads](https://static.pepy.tech/badge/pymilvus/month)](https://pepy.tech/project/pymilvus)\n[![Downloads](https://static.pepy.tech/badge/pymilvus/week)](https://pepy.tech/project/pymilvus)\n\n[![license](https://img.shields.io/hexpm/l/plug.svg?color=green)](https://github.com/milvus-io/pymilvus/blob/master/LICENSE)\n[![Mergify Status][mergify-status]][mergify]\n![Static Badge](https://img.shields.io/badge/slack-%23py--milvus-blue?style=social&logo=slack&link=https%3A%2F%2Fmilvusio.slack.com%2Farchives%2FC024XTWMT4L)\n\n[mergify]: https://mergify.com\n[mergify-status]: https://img.shields.io/endpoint.svg?url=https://api.mergify.com/v1/badges/milvus-io/pymilvus&style=flat\n\nPython SDK for [Milvus](https://github.com/milvus-io/milvus). To contribute code to this project, please read our [contribution guidelines](https://github.com/milvus-io/milvus/blob/master/CONTRIBUTING.md) first. If you have some ideas or encounter a problem, you can find us in the Slack channel [#py-milvus](https://milvusio.slack.com/archives/C024XTWMT4L).\n\n\n## Compatibility\nThe following collection shows Milvus versions and recommended PyMilvus versions:\n\n|Milvus version| Recommended PyMilvus version |\n|:-----:|:-----:|\n| 1.0.\\* | 1.0.1 |\n| 1.1.\\* | 1.1.2 |\n| 2.0.\\* | 2.0.2 |\n| 2.1.\\* | 2.1.3 |\n| 2.2.\\* | 2.2.15 |\n| 2.3.\\* | 2.3.7 |\n| 2.4.\\* | 2.4.0 |\n\n\n## Installation\n\nYou can install PyMilvus via `pip` or `pip3` for Python 3.8+:\n\n```shell\n$ pip3 install pymilvus\n$ pip3 install pymilvus[model] # for milvus-model\n$ pip3 install pymilvus[bulk_writer] # for bulk_writer\n```\n\nYou can install a specific version of PyMilvus by:\n\n```shell\n$ pip3 install pymilvus==2.3.7\n```\n\nYou can upgrade PyMilvus to the latest version by:\n\n```shell\n$ pip3 install --upgrade pymilvus\n```\n\n## FAQ\nQ1. How to get submodules?\n\nA1. The following command will get the protos matching to the generated files, for protos of certain version, see\n[milvus-proto](https://github.com/milvus-io/milvus-proto#usage) for details.\n```shell\n$ git submodule update --init\n```\n\nQ2. How to generate python files from milvus-proto?\n\nA2.\n```shell\n$ make gen_proto\n```\n\nQ3. How to use the local PyMilvus repository for Milvus server?\n\nA3.\n```shell\n$ make install\n```\n\nQ4. How to check coding styles?\n\nA4.\n```shell\nmake lint\n```\n\nQ5. How to fix the coding styles?\n\nA5\n```shell\nmake format\n```\n\nQ6. How to run unittests?\n\nA6\n```shell\n$ pip install \".[dev]\"\n$ make unittest\n```\nQ7. `zsh: no matches found: pymilvus[model]`, how do I solve this?\n\nA7\n```shell\n$ pip install \"pymilvus[model]\"\n```\n\n## Documentation\n\nDocumentation is available online: https://milvus.io/api-reference/pymilvus/v2.4.x/About.md\n\n## Developing package releases\n\nThe commits on the development branch of each version will be packaged and uploaded to [Test PyPI](https://test.pypi.org/).\n\nThe package name generated by the development branch is x.y.z.rc<dist>, where <dist> is the number of commits that differ from the most recent release.\n\n- For example, after the release of **2.3.4**, two commits were submitted on the 2.3 branch.\nThe version number of the latest commit of 2.3 branch is **2.3.5.rc2**.\n\n- For example, after the release of **2.3.4**, 10 commits were submitted on the master branch.\nThe version number of the latest commit of master branch is **2.4.0.rc10**.\n\n\nTo install the package on Test PyPi, you need to append `--extra-index-url` after pip, for example:\n```shell\n$ python3 -m pip install --extra-index-url https://test.pypi.org/simple/ pymilvus==2.1.0.dev66\n```\n\n\n## License\n[Apache License 2.0](LICENSE)\n",
"bugtrack_url": null,
"license": null,
"summary": "Python Sdk for Milvus",
"version": "2.4.3",
"project_urls": {
"repository": "https://github.com/milvus-io/pymilvus"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "420e9ebddc3ee8b500cf6e9f36eb388efbc8bf28ba861a89f6648bdf1031608f",
"md5": "94d49259ea6bda3b0552cfcc025a1d0f",
"sha256": "38239e89f8d739f665141d0b80908990b5f59681e889e135c234a4a45669a5c8"
},
"downloads": -1,
"filename": "pymilvus-2.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "94d49259ea6bda3b0552cfcc025a1d0f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 194110,
"upload_time": "2024-05-17T04:01:58",
"upload_time_iso_8601": "2024-05-17T04:01:58.777861Z",
"url": "https://files.pythonhosted.org/packages/42/0e/9ebddc3ee8b500cf6e9f36eb388efbc8bf28ba861a89f6648bdf1031608f/pymilvus-2.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a53e610e462640038807f1d17abc39e8e14e3f0551fe592345bc1c570fb35c51",
"md5": "6f7c0b05eaf91a2550a4efd0eb9f6f4d",
"sha256": "703ac29296cdce03d6dc2aaebbe959e57745c141a94150e371dc36c61c226cc1"
},
"downloads": -1,
"filename": "pymilvus-2.4.3.tar.gz",
"has_sig": false,
"md5_digest": "6f7c0b05eaf91a2550a4efd0eb9f6f4d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 1209705,
"upload_time": "2024-05-17T04:02:02",
"upload_time_iso_8601": "2024-05-17T04:02:02.178002Z",
"url": "https://files.pythonhosted.org/packages/a5/3e/610e462640038807f1d17abc39e8e14e3f0551fe592345bc1c570fb35c51/pymilvus-2.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-17 04:02:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "milvus-io",
"github_project": "pymilvus",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "build",
"specs": [
[
"==",
"0.4.0"
]
]
},
{
"name": "certifi",
"specs": [
[
"==",
"2023.7.22"
]
]
},
{
"name": "chardet",
"specs": [
[
"==",
"4.0.0"
]
]
},
{
"name": "environs",
"specs": [
[
"==",
"9.5.0"
]
]
},
{
"name": "grpcio",
"specs": [
[
"==",
"1.62.2"
]
]
},
{
"name": "grpcio-testing",
"specs": [
[
"==",
"1.62.2"
]
]
},
{
"name": "grpcio-tools",
"specs": [
[
"==",
"1.62.2"
]
]
},
{
"name": "protobuf",
"specs": [
[
"==",
"4.25.2"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.7"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"20.9"
]
]
},
{
"name": "pep517",
"specs": [
[
"==",
"0.10.0"
]
]
},
{
"name": "pyparsing",
"specs": [
[
"==",
"2.4.7"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "toml",
"specs": [
[
"==",
"0.10.2"
]
]
},
{
"name": "ujson",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"1.26.18"
]
]
},
{
"name": "m2r",
"specs": [
[
"==",
"0.3.1"
]
]
},
{
"name": "Sphinx",
"specs": [
[
"==",
"4.0.0"
]
]
},
{
"name": "sphinx-copybutton",
"specs": []
},
{
"name": "sphinx-rtd-theme",
"specs": []
},
{
"name": "sphinxcontrib-applehelp",
"specs": []
},
{
"name": "sphinxcontrib-devhelp",
"specs": []
},
{
"name": "sphinxcontrib-htmlhelp",
"specs": []
},
{
"name": "sphinxcontrib-jsmath",
"specs": []
},
{
"name": "sphinxcontrib-qthelp",
"specs": []
},
{
"name": "sphinxcontrib-serializinghtml",
"specs": []
},
{
"name": "sphinxcontrib-napoleon",
"specs": []
},
{
"name": "sphinxcontrib-prettyspecialmethods",
"specs": []
},
{
"name": "tqdm",
"specs": [
[
"==",
"4.66.3"
]
]
},
{
"name": "pyarrow",
"specs": [
[
">=",
"12.0.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"5.3.4"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
">=",
"2.8.1"
]
]
},
{
"name": "pytest-timeout",
"specs": [
[
">=",
"1.3.4"
]
]
},
{
"name": "pandas",
"specs": [
[
">=",
"1.1.5"
]
]
},
{
"name": "ruff",
"specs": [
[
">=",
"0.2.0"
]
]
},
{
"name": "black",
"specs": []
},
{
"name": "requests",
"specs": []
},
{
"name": "minio",
"specs": []
},
{
"name": "azure-storage-blob",
"specs": []
},
{
"name": "milvus-lite",
"specs": [
[
">=",
"2.4.0"
]
]
}
],
"lcname": "pymilvus"
}