nvidia-nat-vanna 1.5.0a20260115__py3-none-any.whl

nvidia_nat_vanna-1.5.0a20260115.dist-info/METADATA

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: nvidia-nat-vanna
+Version: 1.5.0a20260115
+Summary: Vanna-based Text-to-SQL integration for NeMo Agent Toolkit with Databricks support
+Keywords: ai,agents,text2sql,vanna,sql,database
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: databricks-sql-connector~=4.1.4
+Requires-Dist: databricks-sqlalchemy~=2.0.8
+Requires-Dist: langchain-core~=1.2.0
+Requires-Dist: nvidia-nat[langchain]==v1.5.0a20260115
+Requires-Dist: pandas~=2.0
+Requires-Dist: pymilvus[model]~=2.6.0
+Requires-Dist: sqlglot~=26.33.0
+Requires-Dist: vanna[chromadb]~=2.0.1
+
+<!--
+SPDX-FileCopyrightText: Copyright (c) 2025-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+SPDX-License-Identifier: Apache-2.0
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+# NVIDIA NeMo Agent Toolkit Vanna
+
+Vanna-based Text-to-SQL integration for NeMo Agent toolkit.
+
+## Overview
+
+This package provides production-ready text-to-SQL capabilities using the Vanna framework with Databricks support.
+
+## Features
+
+- **AI-Powered SQL Generation**: Convert natural language to SQL using LLMs
+- **Databricks Support**: Optimized for Databricks SQL warehouses
+- **Vector-Based Similarity Search**: Milvus integration for few-shot learning
+- **Streaming Support**: Real-time progress updates
+- **Query Execution**: Optional database execution with formatted results
+- **Highly Configurable**: Customizable prompts, examples, and connections
+
+## Quick Start
+
+Install the package:
+
+```bash
+pip install nvidia-nat-vanna
+```
+
+Create a workflow configuration:
+
+```yaml
+functions:
+  text2sql:
+    _type: text2sql
+    llm_name: my_llm
+    embedder_name: my_embedder
+    milvus_retriever: my_retriever
+    database_type: databricks
+    connection_url: "${CONNECTION_URL}"
+    execute_sql: false
+
+  execute_db_query:
+    _type: execute_db_query
+    database_type: databricks
+    connection_url: "${CONNECTION_URL}"
+    max_rows: 100
+
+llms:
+  my_llm:
+    _type: nim
+    model_name: meta/llama-3.1-70b-instruct
+    api_key: "${NVIDIA_API_KEY}"
+
+embedders:
+  my_embedder:
+    _type: nim
+    model_name: nvidia/llama-3.2-nv-embedqa-1b-v2
+    api_key: "${NVIDIA_API_KEY}"
+
+retrievers:
+  my_retriever:
+    _type: milvus_retriever
+    uri: "${MILVUS_URI}"
+    connection_args:
+      user: "developer"
+      password: "${MILVUS_PASSWORD}"
+      db_name: "default"
+    embedding_model: my_embedder
+    content_field: text
+    use_async_client: true
+
+workflow:
+  _type: rewoo_agent
+  tool_names: [text2sql, execute_db_query]
+  llm_name: my_llm
+```
+
+Run the workflow:
+
+```bash
+nat run --config config.yml --input "How many customers do we have?"
+```
+
+## Components
+
+### `text2sql` Function
+
+Generates SQL queries from natural language using:
+- Few-shot learning with similar examples
+- DDL (schema) information
+- Custom documentation
+- LLM-powered query generation
+
+### `execute_db_query` Function
+
+Executes SQL queries and returns formatted results:
+- Databricks SQL execution
+- Result limiting and pagination
+- Structured output format
+- SQLAlchemy Object Relational Mapper (ORM)-based connection
+
+## Use Cases
+
+- **Business Intelligence**: Enable non-technical users to query data
+- **Data Exploration**: Rapid prototyping and analysis
+- **Conversational Analytics**: Multi-turn Q&A about your data
+- **SQL Assistance**: Help analysts write complex queries
+
+## Documentation
+
+Full documentation: <https://docs.nvidia.com/nemo/agent-toolkit/latest/>
+
+## License
+
+Part of NVIDIA NeMo Agent toolkit. See repository for license details.

nvidia_nat_vanna-1.5.0a20260115.dist-info/RECORD

@@ -0,0 +1,13 @@
+nat/meta/pypi.md,sha256=n_m6GJEgCvQ6KT0tRwk3QUeT6-15ettHsW_TmkxtdIY,3405
+nat/plugins/vanna/__init__.py,sha256=hiEJ2ajB5zhZuZOUHAyHfTA9w9UNhygij7hp4yfA6QE,685
+nat/plugins/vanna/db_utils.py,sha256=jYZBDqjNw8GkOFAWlAx2oxTPljSdJipwVRbJ7C6GPqo,9867
+nat/plugins/vanna/execute_db_query.py,sha256=b0LURxOKBNDhqF-LzT5uRp-JeIfAWf9-IttnPXhcsRs,9435
+nat/plugins/vanna/register.py,sha256=ntMAXpC2O70B-fh908o2EimXQbLrbalXa9abi0NCPPc,845
+nat/plugins/vanna/text2sql.py,sha256=egE_2vvySr32EOuPZQsxJ8W7SDtcqSw42BYHwGng6OE,11188
+nat/plugins/vanna/training_db_schema.py,sha256=RaMc48NI6bnksNA3dpY1M_KAluotsiz2HZ9gyCXtvFQ,3147
+nat/plugins/vanna/vanna_utils.py,sha256=b4pYGiDYBu9_eeeZoGNoyswP7FhRafGM6CVntw99AXE,32996
+nvidia_nat_vanna-1.5.0a20260115.dist-info/METADATA,sha256=x_9Vf9hkbn083dDq-dwatOOMbDOcMCAUtJeVJcja0bo,4198
+nvidia_nat_vanna-1.5.0a20260115.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+nvidia_nat_vanna-1.5.0a20260115.dist-info/entry_points.txt,sha256=R-SYyO1XwbN43yqGE5jM4uGhvkJeUmCWIxSl_LIi_rw,56
+nvidia_nat_vanna-1.5.0a20260115.dist-info/top_level.txt,sha256=8-CJ2cP6-f0ZReXe5Hzqp-5pvzzHz-5Ds5H2bGqh1-U,4
+nvidia_nat_vanna-1.5.0a20260115.dist-info/RECORD,,

nvidia_nat_vanna-1.5.0a20260115.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

nvidia_nat_vanna-1.5.0a20260115.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[nat.components]
+nat_vanna = nat.plugins.vanna.register

nvidia_nat_vanna-1.5.0a20260115.dist-info/top_level.txt

@@ -0,0 +1 @@
+nat