Metadata-Version: 2.1
Name: milvus-test
Version: 0.1.0
Summary: Python Sdk for Milvus; Test version
Home-page: https://github.com/milvus-io/pymilvus
License: Apache-2.0
Description: 
        # Milvus Python SDK -- pymilvus
        
        [![version](https://img.shields.io/pypi/v/pymilvus.svg?color=blue)](https://pypi.org/project/pymilvus/)
        [![license](https://img.shields.io/hexpm/l/plug.svg?color=green)](https://github.com/milvus-io/pymilvus/blob/master/LICENSE)
        
        Using Milvus python sdk for Milvus
        Download
        ---
        Pymilvus only supports `python >= 3.4`, is fully tested under 3.4, 3.5, 3.6, 3.7.
        
        
        Pymilvus can be downloaded using `pip`. If no use, try `pip3`
        ```$
        $ pip install pymilvus
        ```
        If you are using `milvus-0.3.0`, last version that supports `milvus-0.3.0` is `0.1.13`, you can download by:
        ```$
        $ pip install pymilvus==0.1.13
        ```
        <span style="color:red">**[Note]** It's NOT recommended to upgrade to higher version if you are still using `milvus-0.3.0`</span>
        
        If you want to upgrade `pymilvus` to newest version
        ```$
        $ pip install --upgrade pymilvus
        ```
        ## Import
        
        ```python
        from milvus import Milvus, IndexType, Status
        ```
        
        ## Getting started
        
        Initial a `Milvus` instance and  `connect` to the sever
        
        ```python
        >>> milvus = Milvus()
        
        >>> milvus.connect(host='SERVER-HOST', port='SERVER-PORT')
        Status(code=0, message="Success")
        ```
        Once successfully connected, you can get the version of server
        
        ```python
        >>> milvus.server_version()
        (Status(code=0, message='Success'), 0.3.1)  # this is example version, the real version may vary
        ```
        ---
        
        Add a new `table`
        
        
        First set param
        ```python
        >>> param = {'table_name':'test01', 'dimension':256, 'index_type':IndexType.FLAT, 'store_raw_vector':False}
        ```
        Then `create table`
        ```python
        >>> milvus.create_table(param)
        Status(message='Table test01 created!', code=0)
        ```
        
        Describe the table we just created
        ```python
        >>> milvus.describe_table('test01')
        (Status(code=0, message='Success!'), TableSchema(table_name='test01',dimension=256, index_type=1, store_raw_vector=False))
        ```
        
        ---
        
        Add vectors into table `test01`
        
        First create 20 vectors of 256-dimension.
        
        - Note that `random` and `pprint` we used here is for creating fake vectors data and pretty print, you may not need them in your project
        
        ```python
        >>> import random
        >>> from pprint import pprint
        
        >>> dim = 256  # Dimension of the vector
        
        # Initialize 20 vectors of 256-dimension
        >>> fake_vectors = [[random.random() for _ in range(dim)] for _ in range(20)]
        ```
        
        Then add vectors into table `test01`
        ```python
        >>> status, ids = milvus.add_vectors(table_name='test01', records=vectors)
        >>> print(status)
        Status(code=0, message='Success')
        >>> pprint(ids) # List of ids returned
        23455321135511233
        12245748929023489
        ...
        ```
        ---
        Search vectors
        
        ```python
        # create 5 vectors of 256-dimension
        >>> q_records = [[random.random() for _ in range(dim)] for _ in range(5)]
        ```
        
        Then get results
        ```python
        >>> status, results = milvus.search_vectors(table_name='test01', query_records=q_records, top_k=10)
        >>> print(status)
        Status(code=0, message='Success')
        >>> pprint(results) # Searched top_k vectors
        ```
        
        ---
        Delet the table we just created
        
        ```python
        >>> milvus.delete_table(table_name='test01')
        Status(code=0, message='Success')
        ```
        Disconnect with the server
        ```python
        >>> milvus.disconnect()
        Status(code=0, message='Success')
        ```
        
        ---
        
        ## Example python
        There are some small examples in `examples/`, you can find more guide there.
        
        Build docs
        ```$
        $ sphinx-build -b html doc/en/ doc/en/build
        ```
        
        
        If you encounter any problems or bugs, please open new issues
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.4
Description-Content-Type: text/markdown
