unixcoder/README.md

# Code & Text Embedding with UniXcoder

*author: [Jael Gu](https://github.com/jaelgu)*

<br />

## Description

A code search operator takes a text string of programming language or natural language as an input
and returns an embedding vector in ndarray which captures the input's core semantic elements.
This operator is implemented with pre-trained [UniXcoder](https://arxiv.org/pdf/2203.03850.pdf) models 
from [Huggingface Transformers](https://huggingface.co/docs/transformers).

<br />

## Code Example

Use the pre-trained model "microsoft/unixcoder-base"
to generate text embeddings for given 
text description "return max value" and code "def max(a,b): if a>b: return a else return b".

*Write a pipeline with explicit inputs/outputs name specifications:*

```python
from towhee import pipe, ops, DataCollection

p = (
    pipe.input('text')
        .map('text', 'embedding', ops.code_search.unixcoder())
        .output('text', 'embedding')
)

DataCollection(p('find max value')).show()
DataCollection(p('def max(a,b): if a>b: return a else return b')).show()
```

<img src="./result.png" width="800px"/>

<br />

## Factory Constructor

Create the operator via the following factory method:

***code_search.unixcoder(model_name="microsoft/unixcoder-base")***

**Parameters:**

***model_name***: *str*

The model name in string.
The default model name is "microsoft/unixcoder-base".

***device***: *str*

The device to run model inference.
The default value is None, which enables GPU if cuda is available.

Supported model names:
- microsoft/unixcoder-base
- microsoft/unixcoder-base-nine

<br />

## Interface

The operator takes a piece of text in string as input.
It loads tokenizer and pre-trained model using model name.
and then return an embedding in ndarray.

***__call__(txt)***

**Parameters:**

***txt***: *str*

​	The text string in programming language or natural language.


**Returns**:

*numpy.ndarray*

​	The text embedding generated by model, in shape of (dim,).


***save_model(format="pytorch", path="default")***

Save model to local with specified format.

**Parameters:**

***format***: *str*

​	The format of saved model, defaults to "pytorch".

***format***: *path*

​	The path where model is saved to. By default, it will save model to the operator directory.


***supported_model_names(format=None)***

Get a list of all supported model names or supported model names for specified model format.

**Parameters:**

***format***: *str*

​	The model format such as "pytorch", "torchscript".
The default value is None, which will return all supported model names.



# More Resources

- [The guide to voyage-code-2 | Voyage AI](https://zilliz.com/ai-models/voyage-code-2): voyage-code-2: Voyage AI's text embedding model optimized for code retrieval (17% better than alternatives).
- [OpenAI text-embedding-3-large | Zilliz](https://zilliz.com/ai-models/text-embedding-3-large): Building GenAI applications with text-embedding-3-large model and Zilliz Cloud / Milvus
- [What Is Semantic Search?](https://zilliz.com/glossary/semantic-search): Semantic search is a search technique that uses natural language processing (NLP) and machine learning (ML) to understand the context and meaning behind a user's search query.
- [Tutorial: Diving into Text Embedding Models | Zilliz Webinar](https://zilliz.com/event/tutorial-text-embedding-models): Register for a free webinar diving into text embedding models in a presentation and tutorial
- [Tutorial: Diving into Text Embedding Models | Zilliz Webinar](https://zilliz.com/event/tutorial-text-embedding-models/success): Register for a free webinar diving into text embedding models in a presentation and tutorial
- [Using Voyage AI's embedding models in Zilliz Cloud Pipelines - Zilliz blog](https://zilliz.com/blog/craft-superior-rag-for-code-intensive-texts-with-zcp-and-voyage): Assess the effectiveness of a RAG system implemented with various embedding models for code-related tasks.