langchain-empiriolabs 0.1.0

An integration package connecting EmpirioLabs and LangChain

langchain-empiriolabs

This package contains the LangChain integration for EmpirioLabs.

EmpirioLabs serves frontier open models (Qwen3, DeepSeek V4, GLM-5.1, Kimi K2.7 Code, MiniMax M3, and more) through one OpenAI-compatible API. Browse the full model catalog at docs.empiriolabs.ai.

Installation

pip install -U langchain-empiriolabs

Set your API key as an environment variable:

export EMPIRIOLABS_API_KEY="your-api-key"

You can create a key from the EmpirioLabs dashboard.

Chat models

ChatEmpirioLabs wraps the EmpirioLabs chat completions API.

from langchain_empiriolabs import ChatEmpirioLabs

llm = ChatEmpirioLabs(model="qwen3-7-plus")

response = llm.invoke("Explain backpropagation in one paragraph.")
print(response.content)

Streaming:

for chunk in llm.stream("Write a haiku about the sea."):
    print(chunk.content, end="", flush=True)

Tool calling:

from pydantic import BaseModel, Field

class GetWeather(BaseModel):
    """Get the current weather in a given location."""

    location: str = Field(..., description="The city and state, e.g. San Francisco, CA")

llm_with_tools = llm.bind_tools([GetWeather])
print(llm_with_tools.invoke("What is the weather in SF?").tool_calls)

Available models

Any model slug from the EmpirioLabs catalog works. Some popular chat slugs:

Slug	Notes
qwen3-7-plus	General-purpose chat (default)
qwen3-7-max	Highest-capability Qwen3
deepseek-v4-pro	Reasoning model
deepseek-v4-flash	Fast, low-cost
glm-5-1	GLM-5.1
kimi-k2-7-code	Coding-focused, reasoning
minimax-m3	MiniMax M3

Reasoning models place their chain-of-thought in response.additional_kwargs["reasoning_content"].

The live list is always available from GET https://api.empiriolabs.ai/v1/models.

Embeddings

EmpirioLabsEmbeddings wraps the EmpirioLabs embeddings API.

from langchain_empiriolabs import EmpirioLabsEmbeddings

embeddings = EmpirioLabsEmbeddings(model="text-embedding-v4")

vector = embeddings.embed_query("Hello, world!")
print(len(vector))

Configuration

Argument	Environment variable	Default
api_key	EMPIRIOLABS_API_KEY	(required)
base_url	EMPIRIOLABS_API_BASE	https://api.empiriolabs.ai/v1

License

MIT