Metadata-Version: 2.4
Name: langchain-timbr
Version: 1.5.2
Summary: LangChain & LangGraph extensions that parse LLM prompts into Timbr semantic SQL and execute them.
Project-URL: Homepage, https://github.com/WPSemantix/langchain-timbr
Project-URL: Documentation, https://docs.timbr.ai/doc/docs/integration/langchain-sdk/
Project-URL: Source, https://github.com/WPSemantix/langchain-timbr
Project-URL: Issues, https://github.com/WPSemantix/langchain-timbr/issues
Author-email: "Timbr.ai" <contact@timbr.ai>
License: MIT
License-File: LICENSE
Keywords: Agents,Knowledge Graph,LLM,LangChain,LangGraph,SQL,Semantic Layer,Timbr
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: <3.13,>=3.9
Requires-Dist: cryptography>=44.0.3
Requires-Dist: langchain-community>=0.3.20
Requires-Dist: langchain-core>=0.3.58
Requires-Dist: langchain>=0.3.25
Requires-Dist: langgraph>=0.3.20
Requires-Dist: pydantic==2.10.4
Requires-Dist: pytimbr-api>=2.0.0
Requires-Dist: tiktoken==0.8.0
Requires-Dist: transformers>=4.51.3
Provides-Extra: all
Requires-Dist: anthropic==0.42.0; extra == 'all'
Requires-Dist: google-generativeai==0.8.4; extra == 'all'
Requires-Dist: langchain-anthropic>=0.3.1; extra == 'all'
Requires-Dist: langchain-google-genai>=2.0.9; extra == 'all'
Requires-Dist: langchain-openai>=0.3.16; extra == 'all'
Requires-Dist: langchain-tests>=0.3.20; extra == 'all'
Requires-Dist: openai==1.77.0; extra == 'all'
Requires-Dist: pyarrow<19.0.0; extra == 'all'
Requires-Dist: pytest==8.3.4; extra == 'all'
Requires-Dist: snowflake-snowpark-python>=1.6.0; extra == 'all'
Requires-Dist: snowflake>=0.8.0; extra == 'all'
Requires-Dist: uvicorn==0.34.0; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: anthropic==0.42.0; extra == 'anthropic'
Requires-Dist: langchain-anthropic>=0.3.1; extra == 'anthropic'
Provides-Extra: dev
Requires-Dist: langchain-tests>=0.3.20; extra == 'dev'
Requires-Dist: pyarrow<19.0.0; extra == 'dev'
Requires-Dist: pytest==8.3.4; extra == 'dev'
Requires-Dist: uvicorn==0.34.0; extra == 'dev'
Provides-Extra: google
Requires-Dist: google-generativeai==0.8.4; extra == 'google'
Requires-Dist: langchain-google-genai>=2.0.9; extra == 'google'
Provides-Extra: openai
Requires-Dist: langchain-openai>=0.3.16; extra == 'openai'
Requires-Dist: openai==1.77.0; extra == 'openai'
Provides-Extra: snowflake
Requires-Dist: snowflake-snowpark-python>=1.6.0; extra == 'snowflake'
Requires-Dist: snowflake>=0.8.0; extra == 'snowflake'
Description-Content-Type: text/markdown

![Timbr logo description](https://timbr.ai/wp-content/uploads/2025/01/logotimbrai230125.png)

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr.svg?type=shield&issueType=security)](https://app.fossa.com/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr?ref=badge_shield&issueType=security)
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr.svg?type=shield&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr?ref=badge_shield&issueType=license)

[![Python 3.9](https://img.shields.io/badge/python-3.9-blue)](https://www.python.org/downloads/release/python-3921/)
[![Python 3.10](https://img.shields.io/badge/python-3.10-blue.svg)](https://www.python.org/downloads/release/python-31017/)
[![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/release/python-31112/)
[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3129/)

# Timbr LangChain LLM SDK

Timbr LangChain LLM SDK is a Python SDK that extends LangChain and LangGraph with custom agents, chains, and nodes for seamless integration with the Timbr semantic layer. It enables converting natural language prompts into optimized semantic-SQL queries and executing them directly against your data.

![Timbr LangGraph pipeline](https://docs.timbr.ai/doc/assets/images/timbr-langgraph-fcf8e2eb7e26dc9dfa8b56b62937281e.png)


## Dependencies
- Access to a timbr-server
- Python from 3.9.13 or newer

## Installation

### Using pip
```bash
python -m pip install langchain-timbr
```

### Using pip from github
```bash
pip install git+https://github.com/WPSemantix/langchain-timbr
```

## Documentation

For comprehensive documentation and usage examples, please visit:

- [Timbr LangChain Documentation](https://docs.timbr.ai/doc/docs/integration/langchain-sdk)
- [Timbr LangGraph Documentation](https://docs.timbr.ai/doc/docs/integration/langgraph-sdk)

## Configuration

The SDK requires several environment variables to be configured. See [`langchain_timbr/config.py`](https://github.com/WPSemantix/langchain-timbr/blob/main/src/langchain_timbr/config.py) for all available configuration options.
