Skip to main content

Reminix adapter for LangGraph - serve agents as REST APIs

Project description

reminix-langgraph

Reminix Runtime adapter for LangGraph. Serve any LangGraph agent as a REST API.

Ready to go live? Deploy to Reminix for zero-config hosting, or self-host on your own infrastructure.

Installation

pip install reminix-langgraph

This will also install reminix-runtime as a dependency.

Quick Start

from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI
from reminix_langgraph import wrap
from reminix_runtime import serve

# Create a LangGraph agent
llm = ChatOpenAI(model="gpt-4o")
graph = create_react_agent(llm, tools=[])

# Wrap it with the Reminix adapter
agent = wrap(graph, name="my-agent")

# Serve it as a REST API
serve([agent], port=8080)

Your agent is now available at:

  • POST /agents/my-agent/invoke - Stateless invocation
  • POST /agents/my-agent/chat - Conversational chat

API Reference

wrap(graph, name)

Wrap a LangGraph compiled graph for use with Reminix Runtime.

Parameter Type Default Description
graph CompiledGraph required A LangGraph compiled graph
name str "langgraph-agent" Name for the agent (used in URL path)

Returns: LangGraphAdapter - A Reminix adapter instance

How It Works

LangGraph uses a state-based approach. The adapter:

  1. Converts incoming messages to LangChain message format
  2. Invokes the graph with {"messages": [...]}
  3. Extracts the last AI message from the response
  4. Returns it in the Reminix response format

Endpoint Input/Output Formats

POST /agents/{name}/invoke

Stateless invocation. Input is passed directly to the graph.

Request:

{
  "input": {
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }
}

Response:

{
  "output": "Hello! How can I help you today?"
}

POST /agents/{name}/chat

Conversational chat with message history.

Request:

{
  "messages": [
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

Response:

{
  "output": "The capital of France is Paris.",
  "messages": [
    {"role": "user", "content": "What is the capital of France?"},
    {"role": "assistant", "content": "The capital of France is Paris."}
  ]
}

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_langgraph-0.0.2.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

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

reminix_langgraph-0.0.2-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file reminix_langgraph-0.0.2.tar.gz.

File metadata

  • Download URL: reminix_langgraph-0.0.2.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","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_langgraph-0.0.2.tar.gz
Algorithm Hash digest
SHA256 690accd3749b1a91c09badabfbc675f92ed2cd35889e3da33cde367ebed993db
MD5 5268db768a4b60aafda05c197c2d304c
BLAKE2b-256 7116c6e2ab48f4b1e59e1ef6579367eba3c6cddfbecdd58e94094b5ecca6b4c5

See more details on using hashes here.

File details

Details for the file reminix_langgraph-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: reminix_langgraph-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 4.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","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_langgraph-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8cf4be4a64c3210c03c6687fbca079ce8e253c4d2b2e9e1bdab6e827479916c8
MD5 7f0ae99e2d8c6e02e00ab99054e8e640
BLAKE2b-256 ab8cbebcc4b7c43386cef74ce87630f65207881c1602d9f4e4f93adb46f04707

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