# NebulaGraph Query Engine Pack
This LlamaPack creates a NebulaGraph query engine, and executes its `query` function. This pack offers the option of creating multiple types of query engines, namely:
- Knowledge graph vector-based entity retrieval (default if no query engine type option is provided)
- Knowledge graph keyword-based entity retrieval
- Knowledge graph hybrid entity retrieval
- Raw vector index retrieval
- Custom combo query engine (vector similarity + KG entity retrieval)
- KnowledgeGraphQueryEngine
- KnowledgeGraphRAGRetriever
## CLI Usage
You can download llamapacks directly using `llamaindex-cli`, which comes installed with the `llama-index` python package:
```bash
llamaindex-cli download-llamapack NebulaGraphQueryEnginePack --download-dir ./nebulagraph_pack
```
You can then inspect the files at `./nebulagraph_pack` and use them as a template for your own project!
## Code Usage
You can download the pack to a `./nebulagraph_pack` directory:
```python
from llama_index.core.llama_pack import download_llama_pack
# download and install dependencies
NebulaGraphQueryEnginePack = download_llama_pack(
"NebulaGraphQueryEnginePack", "./nebulagraph_pack"
)
```
From here, you can use the pack, or inspect and modify the pack in `./nebulagraph_pack`.
Then, you can set up the pack like so:
```bash
pip install llama-index-readers-wikipedia
```
```python
# Load the docs (example of Paleo diet from Wikipedia)
from llama_index.readers.wikipedia import WikipediaReader
loader = WikipediaReader()
docs = loader.load_data(pages=["Paleolithic diet"], auto_suggest=False)
print(f"Loaded {len(docs)} documents")
# get NebulaGraph credentials (assume it's stored in credentials.json)
with open("credentials.json") as f:
nebulagraph_connection_params = json.load(f)
username = nebulagraph_connection_params["username"]
password = nebulagraph_connection_params["password"]
ip_and_port = nebulagraph_connection_params["ip_and_port"]
space_name = "paleo_diet"
edge_types, rel_prop_names = ["relationship"], ["relationship"]
tags = ["entity"]
max_triplets_per_chunk = 10
# create the pack
nebulagraph_pack = NebulaGraphQueryEnginePack(
username=username,
password=password,
ip_and_port=ip_and_port,
space_name=space_name,
edge_types=edge_types,
rel_prop_names=rel_prop_names,
tags=tags,
max_triplets_per_chunk=max_triplets_per_chunk,
docs=docs,
)
```
Optionally, you can pass in the `query_engine_type` from `NebulaGraphQueryEngineType` to construct `NebulaGraphQueryEnginePack`. If `query_engine_type` is not defined, it defaults to Knowledge Graph vector based entity retrieval.
```python
from llama_index.core.packs.nebulagraph_query_engine.base import (
NebulaGraphQueryEngineType,
)
# create the pack
nebulagraph_pack = NebulaGraphQueryEnginePack(
username=username,
password=password,
ip_and_port=ip_and_port,
space_name=space_name,
edge_types=edge_types,
rel_prop_names=rel_prop_names,
tags=tags,
max_triplets_per_chunk=max_triplets_per_chunk,
docs=docs,
query_engine_type=NebulaGraphQueryEngineType.KG_HYBRID,
)
```
`NebulaGraphQueryEnginePack` is a enum defined as follows:
```python
class NebulaGraphQueryEngineType(str, Enum):
"""NebulaGraph query engine type"""
KG_KEYWORD = "keyword"
KG_HYBRID = "hybrid"
RAW_VECTOR = "vector"
RAW_VECTOR_KG_COMBO = "vector_kg"
KG_QE = "KnowledgeGraphQueryEngine"
KG_RAG_RETRIEVER = "KnowledgeGraphRAGRetriever"
```
The `run()` function is a light wrapper around `query_engine.query()`, see a sample query below.
```python
response = nebulagraph_pack.run("Tell me about the benefits of paleo diet.")
```
You can also use modules individually.
```python
# call the query_engine.query()
query_engine = nebulagraph_pack.query_engine
response = query_engine.query("query_str")
```
Raw data
{
"_id": null,
"home_page": null,
"name": "llama-index-packs-nebulagraph-query-engine",
"maintainer": "wenqiglantz",
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "knowledge graph, nebulagraph, query engine",
"author": "Your Name",
"author_email": "you@example.com",
"download_url": "https://files.pythonhosted.org/packages/e9/32/645caf90578688ccaffc117bb0caa552aff0f73033b8e4aec93a6b970e02/llama_index_packs_nebulagraph_query_engine-0.4.0.tar.gz",
"platform": null,
"description": "# NebulaGraph Query Engine Pack\n\nThis LlamaPack creates a NebulaGraph query engine, and executes its `query` function. This pack offers the option of creating multiple types of query engines, namely:\n\n- Knowledge graph vector-based entity retrieval (default if no query engine type option is provided)\n- Knowledge graph keyword-based entity retrieval\n- Knowledge graph hybrid entity retrieval\n- Raw vector index retrieval\n- Custom combo query engine (vector similarity + KG entity retrieval)\n- KnowledgeGraphQueryEngine\n- KnowledgeGraphRAGRetriever\n\n## CLI Usage\n\nYou can download llamapacks directly using `llamaindex-cli`, which comes installed with the `llama-index` python package:\n\n```bash\nllamaindex-cli download-llamapack NebulaGraphQueryEnginePack --download-dir ./nebulagraph_pack\n```\n\nYou can then inspect the files at `./nebulagraph_pack` and use them as a template for your own project!\n\n## Code Usage\n\nYou can download the pack to a `./nebulagraph_pack` directory:\n\n```python\nfrom llama_index.core.llama_pack import download_llama_pack\n\n# download and install dependencies\nNebulaGraphQueryEnginePack = download_llama_pack(\n \"NebulaGraphQueryEnginePack\", \"./nebulagraph_pack\"\n)\n```\n\nFrom here, you can use the pack, or inspect and modify the pack in `./nebulagraph_pack`.\n\nThen, you can set up the pack like so:\n\n```bash\npip install llama-index-readers-wikipedia\n```\n\n```python\n# Load the docs (example of Paleo diet from Wikipedia)\n\nfrom llama_index.readers.wikipedia import WikipediaReader\n\nloader = WikipediaReader()\ndocs = loader.load_data(pages=[\"Paleolithic diet\"], auto_suggest=False)\nprint(f\"Loaded {len(docs)} documents\")\n\n# get NebulaGraph credentials (assume it's stored in credentials.json)\nwith open(\"credentials.json\") as f:\n nebulagraph_connection_params = json.load(f)\n username = nebulagraph_connection_params[\"username\"]\n password = nebulagraph_connection_params[\"password\"]\n ip_and_port = nebulagraph_connection_params[\"ip_and_port\"]\n\nspace_name = \"paleo_diet\"\nedge_types, rel_prop_names = [\"relationship\"], [\"relationship\"]\ntags = [\"entity\"]\nmax_triplets_per_chunk = 10\n\n# create the pack\nnebulagraph_pack = NebulaGraphQueryEnginePack(\n username=username,\n password=password,\n ip_and_port=ip_and_port,\n space_name=space_name,\n edge_types=edge_types,\n rel_prop_names=rel_prop_names,\n tags=tags,\n max_triplets_per_chunk=max_triplets_per_chunk,\n docs=docs,\n)\n```\n\nOptionally, you can pass in the `query_engine_type` from `NebulaGraphQueryEngineType` to construct `NebulaGraphQueryEnginePack`. If `query_engine_type` is not defined, it defaults to Knowledge Graph vector based entity retrieval.\n\n```python\nfrom llama_index.core.packs.nebulagraph_query_engine.base import (\n NebulaGraphQueryEngineType,\n)\n\n# create the pack\nnebulagraph_pack = NebulaGraphQueryEnginePack(\n username=username,\n password=password,\n ip_and_port=ip_and_port,\n space_name=space_name,\n edge_types=edge_types,\n rel_prop_names=rel_prop_names,\n tags=tags,\n max_triplets_per_chunk=max_triplets_per_chunk,\n docs=docs,\n query_engine_type=NebulaGraphQueryEngineType.KG_HYBRID,\n)\n```\n\n`NebulaGraphQueryEnginePack` is a enum defined as follows:\n\n```python\nclass NebulaGraphQueryEngineType(str, Enum):\n \"\"\"NebulaGraph query engine type\"\"\"\n\n KG_KEYWORD = \"keyword\"\n KG_HYBRID = \"hybrid\"\n RAW_VECTOR = \"vector\"\n RAW_VECTOR_KG_COMBO = \"vector_kg\"\n KG_QE = \"KnowledgeGraphQueryEngine\"\n KG_RAG_RETRIEVER = \"KnowledgeGraphRAGRetriever\"\n```\n\nThe `run()` function is a light wrapper around `query_engine.query()`, see a sample query below.\n\n```python\nresponse = nebulagraph_pack.run(\"Tell me about the benefits of paleo diet.\")\n```\n\nYou can also use modules individually.\n\n```python\n# call the query_engine.query()\nquery_engine = nebulagraph_pack.query_engine\nresponse = query_engine.query(\"query_str\")\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "llama-index packs nebulagraph_query_engine integration",
"version": "0.4.0",
"project_urls": null,
"split_keywords": [
"knowledge graph",
" nebulagraph",
" query engine"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5e6afb8ef652aead5a3494486f832c20534254e589fc848f758943351f19d223",
"md5": "04264fd763acd871e4ff2d031d769a9d",
"sha256": "155cccd082090f7e0aa518ffe185032fa88c91d7cdb7dc9c4e10d86ce9a0d747"
},
"downloads": -1,
"filename": "llama_index_packs_nebulagraph_query_engine-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "04264fd763acd871e4ff2d031d769a9d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 5030,
"upload_time": "2024-11-18T01:33:29",
"upload_time_iso_8601": "2024-11-18T01:33:29.644839Z",
"url": "https://files.pythonhosted.org/packages/5e/6a/fb8ef652aead5a3494486f832c20534254e589fc848f758943351f19d223/llama_index_packs_nebulagraph_query_engine-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e932645caf90578688ccaffc117bb0caa552aff0f73033b8e4aec93a6b970e02",
"md5": "8b3455d39ee57d45a51d1e1bb5bf9621",
"sha256": "840723f5e8dad73a455fccbe6ab33d1670bf25c9ad29df4f221753c2d89392ef"
},
"downloads": -1,
"filename": "llama_index_packs_nebulagraph_query_engine-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "8b3455d39ee57d45a51d1e1bb5bf9621",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 4500,
"upload_time": "2024-11-18T01:33:31",
"upload_time_iso_8601": "2024-11-18T01:33:31.942627Z",
"url": "https://files.pythonhosted.org/packages/e9/32/645caf90578688ccaffc117bb0caa552aff0f73033b8e4aec93a6b970e02/llama_index_packs_nebulagraph_query_engine-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-18 01:33:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "llama-index-packs-nebulagraph-query-engine"
}
JSON