Reminix adapter for LangChain - serve agents as REST APIs
Project description
reminix-langchain
Reminix Runtime adapter for LangChain. Serve any LangChain runnable as a REST API.
Ready to go live? Deploy to Reminix Cloud for zero-config hosting, or self-host on your own infrastructure.
Installation
pip install reminix-langchain
This will also install reminix-runtime as a dependency.
Quick Start
from langchain_openai import ChatOpenAI
from reminix_langchain import serve_agent
llm = ChatOpenAI(model="gpt-4o")
serve_agent(llm, name="my-chatbot", port=8080)
For more flexibility (e.g., serving multiple agents), use wrap_agent and serve separately:
from langchain_openai import ChatOpenAI
from reminix_langchain import wrap_agent
from reminix_runtime import serve
llm = ChatOpenAI(model="gpt-4o")
agent = wrap_agent(llm, name="my-chatbot")
serve(agents=[agent], port=8080)
Your agent is now available at:
POST /agents/my-chatbot/invoke- Execute the agent
API Reference
serve_agent(runnable, name, port, host)
Wrap a LangChain runnable and serve it immediately. Combines wrap_agent and serve for single-agent setups.
| Parameter | Type | Default | Description |
|---|---|---|---|
runnable |
Runnable |
required | Any LangChain runnable (LLM, chain, agent, etc.) |
name |
str |
"langchain-agent" |
Name for the agent (used in URL path) |
port |
int |
8080 |
Port to serve on |
host |
str |
"0.0.0.0" |
Host to bind to |
wrap_agent(runnable, name)
Wrap a LangChain runnable for use with Reminix Runtime. Use this with serve from reminix_runtime for multi-agent setups.
| Parameter | Type | Default | Description |
|---|---|---|---|
runnable |
Runnable |
required | Any LangChain runnable (LLM, chain, agent, etc.) |
name |
str |
"langchain-agent" |
Name for the agent (used in URL path) |
Returns: LangChainAgentAdapter - A Reminix adapter instance
Example with a Chain
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate
from reminix_langchain import wrap_agent
from reminix_runtime import serve
# Create a chain
prompt = ChatPromptTemplate.from_messages([
("system", "You are a helpful assistant."),
("human", "{input}")
])
llm = ChatOpenAI(model="gpt-4o")
chain = prompt | llm
# Wrap and serve
agent = wrap_agent(chain, name="my-chain")
serve(agents=[agent], port=8080)
Endpoint Input/Output Formats
POST /agents/{name}/invoke
Execute the agent with a prompt or messages.
Request with prompt:
{
"prompt": "Summarize this text: ..."
}
Request with messages:
{
"messages": [
{"role": "user", "content": "Hello!"}
]
}
Response:
{
"output": "Hello! How can I help you today?"
}
Streaming
For streaming responses, set stream: true in the request:
{
"prompt": "Tell me a story",
"stream": true
}
The response will be sent as Server-Sent Events (SSE).
Runtime Documentation
For information about the server, endpoints, request/response formats, and more, see the reminix-runtime package.
Deployment
Ready to go live?
- Deploy to Reminix Cloud - Zero-config cloud hosting
- Self-host - Run on your own infrastructure
Links
License
Apache-2.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file reminix_langchain-0.0.18.tar.gz.
File metadata
- Download URL: reminix_langchain-0.0.18.tar.gz
- Upload date:
- Size: 11.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
05d73470edf3a7192a23eb1dd9f9aebd96163ab13e21e1a3c89da852e1a0c2b9
|
|
| MD5 |
da8b8f47fcb78ac38c923c87e77f4082
|
|
| BLAKE2b-256 |
7f949d138cc1c158dc1797185446c210d24f3159e869587e1dce13aadd57aa67
|
File details
Details for the file reminix_langchain-0.0.18-py3-none-any.whl.
File metadata
- Download URL: reminix_langchain-0.0.18-py3-none-any.whl
- Upload date:
- Size: 9.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cd6501403397a4f0eff0e11c718c097e8f6dc3822e9dedad22cc08aa256c0a7a
|
|
| MD5 |
11908135ddf58bea258ff706d74d9d04
|
|
| BLAKE2b-256 |
32605911b4b0e7933752b0f3dcdbf4940be625099db0fdfa662008ebacaef1a0
|