Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/neumtry/neumai

Neum AI is a best-in-class framework to manage the creation and synchronization of vector embeddings at large scale.
https://github.com/neumtry/neumai

ai chatgpt data data-engineering database embeddings etl llm llmops mlops ops pipeline python rag retrieval vector-database vectors

Last synced: 3 months ago
JSON representation

Neum AI is a best-in-class framework to manage the creation and synchronization of vector embeddings at large scale.

Awesome Lists containing this project

README

        

Neum AI



[Homepage](https://www.neum.ai) | [Documentation](https://docs.neum.ai) | [Blog](https://neum.ai/blog) | [Discord](https://discord.gg/mJeNZYRz4m) | [Twitter](https://twitter.com/neum_ai)



PyPI

![Neum AI Hero](https://uploads-ssl.webflow.com/6552c062a6c96c60086c77df/6557cfde1ff0648321e5d3ba_Group%2066.png)

**[Neum AI](https://neum.ai) is a data platform that helps developers leverage their data to contextualize Large Language Models through Retrieval Augmented Generation (RAG)** This includes
extracting data from existing data sources like document storage and NoSQL, processing the contents into vector embeddings and ingesting the vector embeddings into vector databases for similarity search.

It provides you a comprehensive solution for RAG that can scale with your application and reduce the time spent integrating services like data connectors, embedding models and vector databases.

## Features

- 🏭 **High throughput distributed architecture** to handle billions of data points. Allows high degrees of parallelization to optimize embedding generation and ingestion.
- 🧱 **Built-in data connectors** to common data sources, embedding services and vector stores.
- 🔄 **Real-time synchronization** of data sources to ensure your data is always up-to-date.
- ♻ **Customizable data pre-processing** in the form of loading, chunking and selecting.
- 🤝 **Cohesive data management** to support hybrid retrieval with metadata. Neum AI automatically augments and tracks metadata to provide rich retrieval experience.

## Talk to us

You can reach our team either through email ([[email protected]](mailto:[email protected])), on [discord](https://discord.gg/mJeNZYRz4m) or by [scheduling a call wit us](https://calendly.com/neum-ai/neum-ai-demo?month=2023-12).

## Getting Started

### Neum AI Cloud

Sign up today at [dashboard.neum.ai](https://dashboard.neum.ai). See our [quickstart](https://docs.neum.ai/get-started/quickstart) to get started.

The Neum AI Cloud supports a large-scale, distributed architecture to run millions of documents through vector embedding. For the full set of features see: [Cloud vs Local](https://neumai.mintlify.app/get-started/cloud-vs-local)

### Local Development

Install the [`neumai`](https://pypi.org/project/neumai/) package:

```bash
pip install neumai
```

To create your first data pipelines visit our [quickstart](https://docs.neum.ai/get-started/quickstart).

At a high level, a pipeline consists of one or multiple sources to pull data from, one embed connector to vectorize the content, and one sink connector to store said vectors.
With this snippet of code we will craft all of these and run a pipeline:


### Creating and running a pipeline


```python

from neumai.DataConnectors.WebsiteConnector import WebsiteConnector
from neumai.Shared.Selector import Selector
from neumai.Loaders.HTMLLoader import HTMLLoader
from neumai.Chunkers.RecursiveChunker import RecursiveChunker
from neumai.Sources.SourceConnector import SourceConnector
from neumai.EmbedConnectors import OpenAIEmbed
from neumai.SinkConnectors import WeaviateSink
from neumai.Pipelines import Pipeline

website_connector = WebsiteConnector(
url = "https://www.neum.ai/post/retrieval-augmented-generation-at-scale",
selector = Selector(
to_metadata=['url']
)
)
source = SourceConnector(
data_connector = website_connector,
loader = HTMLLoader(),
chunker = RecursiveChunker()
)

openai_embed = OpenAIEmbed(
api_key = "",
)

weaviate_sink = WeaviateSink(
url = "your-weaviate-url",
api_key = "your-api-key",
class_name = "your-class-name",
)

pipeline = Pipeline(
sources=[source],
embed=openai_embed,
sink=weaviate_sink
)
pipeline.run()

results = pipeline.search(
query="What are the challenges with scaling RAG?",
number_of_results=3
)

for result in results:
print(result.metadata)
```

### Creating and running a pipeline - Postgres connector

```python

from neumai.DataConnectors.PostgresConnector import PostgresConnector
from neumai.Shared.Selector import Selector
from neumai.Loaders.JSONLoader import JSONLoader
from neumai.Chunkers.RecursiveChunker import RecursiveChunker
from neumai.Sources.SourceConnector import SourceConnector
from neumai.EmbedConnectors import OpenAIEmbed
from neumai.SinkConnectors import WeaviateSink
from neumai.Pipelines import Pipeline

website_connector = PostgresConnector(
connection_string = 'postgres',
query = 'Select * from ...'
)
source = SourceConnector(
data_connector = website_connector,
loader = JSONLoader(
id_key='',
selector=Selector(
to_embed=['property1_to_embed','property2_to_embed'],
to_metadata=['property3_to_include_in_metadata_in_vector']
)
),
chunker = RecursiveChunker()
)

openai_embed = OpenAIEmbed(
api_key = "",
)

weaviate_sink = WeaviateSink(
url = "your-weaviate-url",
api_key = "your-api-key",
class_name = "your-class-name",
)

pipeline = Pipeline(
sources=[source],
embed=openai_embed,
sink=weaviate_sink
)

pipeline.run()

results = pipeline.search(
query="...",
number_of_results=3
)

for result in results:
print(result.metadata)
```


### Publishing pipeline to Neum Cloud


```python
from neumai.Client.NeumClient import NeumClient
client = NeumClient(
api_key='

### Self-host

If you are interested in deploying Neum AI to your own cloud contact us at [[email protected]](mailto:[email protected]).

We have a sample backend architecture published on [GitHub](https://github.com/NeumTry/neum-at-scale) which you can use as a starting point.

## Available Connectors
For an up-to-date list please visit our [docs](https://docs.neum.ai/components/sourceConnector)

### Source connectors
1. Postgres
2. Hosted Files
3. Websites
4. S3
5. Azure Blob
6. Sharepoint
7. Singlestore
8. Supabase Storage

### Embed Connectors
1. OpenAI embeddings
2. Azure OpenAI embeddings

### Sink Connectors
1. Supabase postgres
2. Weaviate
3. Qdrant
4. Pinecone
5. Singlestore

## Roadmap
Our roadmap is evolving with asks, so if there is anything missing feel free to open an issue or send us a message.


Connectors
- [ ] MySQL - Source
- [ ] GitHub - Source
- [ ] Google Drive - Source
- [ ] Hugging Face - Embedding
- [x] LanceDB - Sink
- [x] Marqo - Sink
- [ ] Milvus - Sink
- [ ] Chroma - Sink

Search
- [x] Retrieval feedback
- [x] Filter support
- [x] Unified Neum AI filters
- [ ] Smart routing (w/ embedding based classification)
- [ ] Smart routing (w/ LLM based classification)
- [ ] Self-Query Retrieval (w/ Metadata attributes generation)

Extensibility
- [x] Langchain / Llama Index Document to Neum Document converter
- [ ] Custom chunking and loading

Experimental
- [ ] Async metadata augmentation
- [ ] Chat history connector
- [ ] Structured (SQL and GraphQL) search connector

## Neum Tools
Additional tooling for Neum AI can be found here:

- [neumai-tools](https://pypi.org/project/neumai-tools/): contains pre-processing tools for loading and chunking data before generating vector embeddings.