Install & Compatibility
Where this runs
tested against v1.1.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 2.607s · 68.1MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 6.9s · import 2.359s · 76MB
71MB installed
● package 71MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
ChatSambaNova
✓ from langchain_sambanova import ChatSambaNova
Primary class for interacting with SambaNova chat models.
SambaNovaEmbeddings
✓ from langchain_sambanova import SambaNovaEmbeddings
Primary class for interacting with SambaNova embedding models.
SambaStudio
✓ from langchain_community.llms import SambaStudio
✗ from langchain_sambanova import SambaStudio
While 'SambaStudio' exists in `langchain_community`, the dedicated `langchain-sambanova` package provides `ChatSambaNova` and `SambaNovaEmbeddings` as the current and recommended interfaces for SambaNova models. The `langchain_community.llms.SambaStudio` is part of an older or broader integration.
This quickstart demonstrates how to set up and use the `ChatSambaNova` model for chat completions and `SambaNovaEmbeddings` for text embeddings. It requires setting `SAMBANOVA_API_KEY` (and optionally `SAMBANOVA_API_BASE` for SambaStack) as environment variables.
import os
from langchain_sambanova import ChatSambaNova
from langchain_core.messages import HumanMessage
# Ensure SAMBANOVA_API_KEY is set as an environment variable
# For SambaStack, SAMBANOVA_API_BASE might also be required.
os.environ['SAMBANOVA_API_KEY'] = os.environ.get('SAMBANOVA_API_KEY', 'your_sambanova_api_key_here')
# Initialize the SambaNova Chat model
llm = ChatSambaNova(
model="Meta-Llama-3.3-70B-Instruct", # Replace with your desired model
max_tokens=1024,
temperature=0.7,
top_p=0.01,
)
# Invoke the model with a message
messages = [
("system", "You are a helpful assistant that translates English to French."),
("human", "I love programming."),
]
response = llm.invoke(messages)
print(response.content)
# Example for embeddings
from langchain_sambanova import SambaNovaEmbeddings
embeddings = SambaNovaEmbeddings(model="E5-Mistral-7B-Instruct") # Replace with your desired embedding model
query_embedding = embeddings.embed_query("What is the meaning of life?")
print(f"Embedding snippet: {str(query_embedding)[:50]}...")
Debug
Known issues
breakingVersion 1.1.0 includes fixes related to 'langchain-core 1.2+ security restrictions' and handling of 'AIMessage content_blocks format'. Older code relying on previous serialization behavior or specific AIMessage structures with `langchain-core < 1.2` might break or behave unexpectedly.fixUpgrade to `langchain-sambanova>=1.1.0` and `langchain-core>=1.2.0`. Review any custom serialization logic or message parsing that interacts with `AIMessage` content.
affects: <1.1.0
gotchaAuthentication requires setting environment variables `SAMBANOVA_API_KEY` and, for SambaStack users, `SAMBANOVA_API_BASE`. Failing to set these will result in authentication errors.fixEnsure `export SAMBANOVA_API_KEY="your-key-here"` is run in your environment. For SambaStack, also set `export SAMBANOVA_API_BASE="your-base-url-here"`.
affects: All versions
breakingThe jump from `v0.2.0` to `v1.0.0` often indicates significant changes and potential API breakage, even if not explicitly detailed in the changelog as 'breaking'. Users upgrading across this major version boundary should expect refactorings.fixRefer to the official SambaNova LangChain documentation and the library's GitHub README for any migration guides or updated API signatures when upgrading to version 1.0.0 or higher.
affects: Upgrading from <1.0.0 to >=1.0.0
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'langchain_sambanova'
The `langchain-sambanova` package is not installed in the current Python environment.
fixRun `pip install langchain-sambanova` to install the package. Ensure your environment is activated if using virtual environments.
ValueError: Did not find sensibility_api_key, please add an environment variable SAMBANOVA_API_KEY
The `SAMBANOVA_API_KEY` environment variable, which is required for authenticating with SambaNova services, has not been set.
fixSet the environment variable: `export SAMBANOVA_API_KEY="your_api_key_here"` (replace with your actual API key from cloud.sambanova.ai). For SambaStack, also set `SAMBANOVA_API_BASE`.
Failed to serialize object: The `content_blocks` field for `AIMessage` is not supported with this `langchain-core` version.
An older version of `langchain-core` or `langchain-sambanova` is being used which does not correctly handle the `AIMessage` content block format, a common issue fixed in `langchain-sambanova` v1.1.0.
fixUpgrade both `langchain-sambanova` and `langchain-core` to their latest versions: `pip install -U langchain-sambanova langchain-core`.
Upgrade
Version history
1.1.0latest on PyPI · released Feb 3, 2026
Audit
Dependencies
langchain-corerequiredCore components of LangChain are required for integration classes and proper serialization handling.
langchainrequiredThe umbrella package for the LangChain framework, providing essential utilities and abstractions for building LLM applications.
sambanovarequiredThe underlying official SambaNova Python SDK that the LangChain integration package builds upon.