[](https://app.fossa.com/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr?ref=badge_shield&issueType=security)
[](https://app.fossa.com/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr?ref=badge_shield&issueType=license)
[](https://www.python.org/downloads/release/python-31017/)
[](https://www.python.org/downloads/release/python-31112/)
[](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.
## Dependencies
- Access to a timbr-server
- Python 3.10 or newer
## Installation
### Using pip
```bash
python -m pip install langchain-timbr
```
### Install with selected LLM providers
#### One of: openai, anthropic, google, azure_openai, snowflake, databricks, vertex_ai (or 'all')
```bash
python -m pip install 'langchain-timbr[<your selected providers, separated by comma w/o space>]'
```
### 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 uses environment variables for configuration. All configurations are optional - when set, they serve as default values for `langchain-timbr` provided tools. Below are all available configuration options:
### Configuration Options
#### Timbr Connection Settings
- **`TIMBR_URL`** - The URL of your Timbr server
- **`TIMBR_TOKEN`** - Authentication token for accessing the Timbr server
- **`TIMBR_ONTOLOGY`** - The ontology to use (also accepts `ONTOLOGY` as an alias)
- **`IS_JWT`** - Whether the token is a JWT token (true/false)
- **`JWT_TENANT_ID`** - Tenant ID for JWT authentication
#### Cache and Data Processing
- **`CACHE_TIMEOUT`** - Timeout for caching operations in seconds
- **`IGNORE_TAGS`** - Comma-separated list of tags to ignore during processing
- **`IGNORE_TAGS_PREFIX`** - Comma-separated list of tag prefixes to ignore during processing
#### LLM Configuration
- **`LLM_TYPE`** - The type of LLM provider to use
- **`LLM_MODEL`** - The specific model to use with the LLM provider
- **`LLM_API_KEY`** - API key or client secret for the LLM provider
- **`LLM_TEMPERATURE`** - Temperature setting for LLM responses (controls randomness)
- **`LLM_ADDITIONAL_PARAMS`** - Additional parameters to pass to the LLM
- **`LLM_TIMEOUT`** - Timeout for LLM requests in seconds
- **`LLM_TENANT_ID`** - LLM provider tenant/directory ID (Used for Service Principal authentication)
- **`LLM_CLIENT_ID`** - LLM provider client ID (Used for Service Principal authentication)
- **`LLM_CLIENT_SECRET`** - LLM provider client secret (Used for Service Principal authentication)
- **`LLM_ENDPOINT`** - LLM provider OpenAI endpoint URL
- **`LLM_API_VERSION`** - LLM provider API version
- **`LLM_SCOPE`** - LLM provider authentication scope
Raw data
{
"_id": null,
"home_page": null,
"name": "langchain-timbr",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "Agents, Knowledge Graph, LLM, LangChain, LangGraph, SQL, Semantic Layer, Timbr",
"author": null,
"author_email": "\"Timbr.ai\" <contact@timbr.ai>",
"download_url": "https://files.pythonhosted.org/packages/f0/21/2c5345eef7639b75836cf3e830b75f1b19caa5b307b25602bdb34a3225cf/langchain_timbr-2.1.1.tar.gz",
"platform": null,
"description": "\n\n[](https://app.fossa.com/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr?ref=badge_shield&issueType=security)\n[](https://app.fossa.com/projects/git%2Bgithub.com%2FWPSemantix%2Flangchain-timbr?ref=badge_shield&issueType=license)\n\n\n[](https://www.python.org/downloads/release/python-31017/)\n[](https://www.python.org/downloads/release/python-31112/)\n[](https://www.python.org/downloads/release/python-3129/)\n\n# Timbr LangChain LLM SDK\n\nTimbr 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.\n\n\n\n## Dependencies\n\n- Access to a timbr-server\n- Python 3.10 or newer\n\n## Installation\n\n### Using pip\n\n```bash\npython -m pip install langchain-timbr\n```\n\n### Install with selected LLM providers\n\n#### One of: openai, anthropic, google, azure_openai, snowflake, databricks, vertex_ai (or 'all')\n\n```bash\npython -m pip install 'langchain-timbr[<your selected providers, separated by comma w/o space>]'\n```\n\n### Using pip from github\n\n```bash\npip install git+https://github.com/WPSemantix/langchain-timbr\n```\n\n## Documentation\n\nFor comprehensive documentation and usage examples, please visit:\n\n- [Timbr LangChain Documentation](https://docs.timbr.ai/doc/docs/integration/langchain-sdk)\n- [Timbr LangGraph Documentation](https://docs.timbr.ai/doc/docs/integration/langgraph-sdk)\n\n## Configuration\n\nThe SDK uses environment variables for configuration. All configurations are optional - when set, they serve as default values for `langchain-timbr` provided tools. Below are all available configuration options:\n\n### Configuration Options\n\n#### Timbr Connection Settings\n\n- **`TIMBR_URL`** - The URL of your Timbr server\n- **`TIMBR_TOKEN`** - Authentication token for accessing the Timbr server\n- **`TIMBR_ONTOLOGY`** - The ontology to use (also accepts `ONTOLOGY` as an alias)\n- **`IS_JWT`** - Whether the token is a JWT token (true/false)\n- **`JWT_TENANT_ID`** - Tenant ID for JWT authentication\n\n#### Cache and Data Processing\n\n- **`CACHE_TIMEOUT`** - Timeout for caching operations in seconds\n- **`IGNORE_TAGS`** - Comma-separated list of tags to ignore during processing\n- **`IGNORE_TAGS_PREFIX`** - Comma-separated list of tag prefixes to ignore during processing\n\n#### LLM Configuration\n\n- **`LLM_TYPE`** - The type of LLM provider to use\n- **`LLM_MODEL`** - The specific model to use with the LLM provider\n- **`LLM_API_KEY`** - API key or client secret for the LLM provider\n- **`LLM_TEMPERATURE`** - Temperature setting for LLM responses (controls randomness)\n- **`LLM_ADDITIONAL_PARAMS`** - Additional parameters to pass to the LLM\n- **`LLM_TIMEOUT`** - Timeout for LLM requests in seconds\n- **`LLM_TENANT_ID`** - LLM provider tenant/directory ID (Used for Service Principal authentication)\n- **`LLM_CLIENT_ID`** - LLM provider client ID (Used for Service Principal authentication)\n- **`LLM_CLIENT_SECRET`** - LLM provider client secret (Used for Service Principal authentication)\n- **`LLM_ENDPOINT`** - LLM provider OpenAI endpoint URL\n- **`LLM_API_VERSION`** - LLM provider API version\n- **`LLM_SCOPE`** - LLM provider authentication scope\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "LangChain & LangGraph extensions that parse LLM prompts into Timbr semantic SQL and execute them.",
"version": "2.1.1",
"project_urls": {
"Documentation": "https://docs.timbr.ai/doc/docs/integration/langchain-sdk/",
"Homepage": "https://github.com/WPSemantix/langchain-timbr",
"Issues": "https://github.com/WPSemantix/langchain-timbr/issues",
"Source": "https://github.com/WPSemantix/langchain-timbr"
},
"split_keywords": [
"agents",
" knowledge graph",
" llm",
" langchain",
" langgraph",
" sql",
" semantic layer",
" timbr"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6e04e0b0aa185ab1db629123693fd4afb59303e9d460a3f15811fc6167bad611",
"md5": "d0d9ca85749a0ff174759ac2c818727d",
"sha256": "6ce638c9d8273f89179335dfc93f2259edd1b5d24f34600b2d1f337032d5a999"
},
"downloads": -1,
"filename": "langchain_timbr-2.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d0d9ca85749a0ff174759ac2c818727d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 56800,
"upload_time": "2025-10-30T08:31:39",
"upload_time_iso_8601": "2025-10-30T08:31:39.655883Z",
"url": "https://files.pythonhosted.org/packages/6e/04/e0b0aa185ab1db629123693fd4afb59303e9d460a3f15811fc6167bad611/langchain_timbr-2.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f0212c5345eef7639b75836cf3e830b75f1b19caa5b307b25602bdb34a3225cf",
"md5": "5ba3be2a5e3511a6e40eb0d66263315e",
"sha256": "e87c1b41774a0d383f4ec3d2c8bf72c641423a063e7339ad233dd2d7ce2c41d6"
},
"downloads": -1,
"filename": "langchain_timbr-2.1.1.tar.gz",
"has_sig": false,
"md5_digest": "5ba3be2a5e3511a6e40eb0d66263315e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 54132,
"upload_time": "2025-10-30T08:31:41",
"upload_time_iso_8601": "2025-10-30T08:31:41.218912Z",
"url": "https://files.pythonhosted.org/packages/f0/21/2c5345eef7639b75836cf3e830b75f1b19caa5b307b25602bdb34a3225cf/langchain_timbr-2.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-30 08:31:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WPSemantix",
"github_project": "langchain-timbr",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "anthropic",
"specs": [
[
"==",
"0.42.0"
]
]
},
{
"name": "azure-identity",
"specs": [
[
"==",
"1.25.0"
]
]
},
{
"name": "cryptography",
"specs": [
[
"==",
"45.0.7"
]
]
},
{
"name": "databricks-langchain",
"specs": [
[
"==",
"0.7.1"
]
]
},
{
"name": "databricks-sdk",
"specs": [
[
"==",
"0.64.0"
]
]
},
{
"name": "google-generativeai",
"specs": [
[
"==",
"0.8.4"
]
]
},
{
"name": "langchain",
"specs": [
[
"==",
"0.3.27"
]
]
},
{
"name": "langchain-anthropic",
"specs": [
[
"==",
"0.3.5"
]
]
},
{
"name": "langchain-community",
"specs": [
[
"==",
"0.3.30"
]
]
},
{
"name": "langchain-core",
"specs": [
[
"==",
"0.3.78"
]
]
},
{
"name": "langchain-google-genai",
"specs": [
[
"==",
"2.0.10"
]
]
},
{
"name": "langchain-google-vertexai",
"specs": [
[
"==",
"2.1.2"
]
]
},
{
"name": "langchain-openai",
"specs": [
[
"==",
"0.3.34"
]
]
},
{
"name": "langchain-tests",
"specs": [
[
"==",
"0.3.22"
]
]
},
{
"name": "langgraph",
"specs": [
[
"==",
"0.6.8"
]
]
},
{
"name": "openai",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
"==",
"2.10.4"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"8.3.4"
]
]
},
{
"name": "pytimbr_api",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "snowflake",
"specs": [
[
"==",
"1.8.0"
]
]
},
{
"name": "snowflake-snowpark-python",
"specs": [
[
"==",
"1.39.1"
]
]
},
{
"name": "tiktoken",
"specs": [
[
"==",
"0.8.0"
]
]
},
{
"name": "transformers",
"specs": [
[
"==",
"4.57.0"
]
]
},
{
"name": "uvicorn",
"specs": [
[
"==",
"0.34.0"
]
]
}
],
"lcname": "langchain-timbr"
}
JSON
