Skip to main content

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/execute - 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}/execute

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?

Links

License

Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

reminix_langchain-0.0.9.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

reminix_langchain-0.0.9-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file reminix_langchain-0.0.9.tar.gz.

File metadata

  • Download URL: reminix_langchain-0.0.9.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","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

Hashes for reminix_langchain-0.0.9.tar.gz
Algorithm Hash digest
SHA256 e11f25be36c603aaf6cc776f58d2680261e0a61d9a37015535ae2b85fd5fa88d
MD5 cc424c8918d1914afaf3a06fe48d7b7c
BLAKE2b-256 186b3424c62a41ca4b617a9790e00008eedfb3e7021f941da63487ebf1689352

See more details on using hashes here.

File details

Details for the file reminix_langchain-0.0.9-py3-none-any.whl.

File metadata

  • Download URL: reminix_langchain-0.0.9-py3-none-any.whl
  • Upload date:
  • Size: 9.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","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

Hashes for reminix_langchain-0.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 6b62fa731d19f5f20c7a277246cd5f382d66b04ff5f4baf393669aa5be0bc130
MD5 64fea1ee058642d43cc827bb32c1fa2d
BLAKE2b-256 5461132da39b7cf3bb057a893ebd1c0cea05fbb26b44956d30f519da263b1109

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page