@reminix/langgraph

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

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

Installation

npm install @reminix/langgraph @langchain/langgraph

This will also install @reminix/runtime as a dependency.

Quick Start

import { createReactAgent } from '@langchain/langgraph/prebuilt';
import { ChatOpenAI } from '@langchain/openai';
import { serveAgent } from '@reminix/langgraph';

const llm = new ChatOpenAI({ model: 'gpt-4o' });
const graph = createReactAgent({ llm, tools: [] });
serveAgent(graph, { name: 'my-agent', port: 8080 });

For more flexibility (e.g., serving multiple agents), use wrapAgent and serve separately:

import { createReactAgent } from '@langchain/langgraph/prebuilt';
import { ChatOpenAI } from '@langchain/openai';
import { wrapAgent } from '@reminix/langgraph';
import { serve } from '@reminix/runtime';

const llm = new ChatOpenAI({ model: 'gpt-4o' });
const graph = createReactAgent({ llm, tools: [] });
const agent = wrapAgent(graph, 'my-agent');
serve({ agents: [agent], port: 8080 });

Your agent is now available at:

• POST /agents/my-agent/invoke - Execute the agent

API Reference

serveAgent(graph, options)

Wrap a LangGraph graph and serve it immediately. Combines wrapAgent and serve for single-agent setups.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | graph | CompiledGraph | required | A LangGraph compiled graph | | options.name | string | "langgraph-agent" | Name for the agent (used in URL path) | | options.port | number | 8080 | Port to serve on | | options.hostname | string | "0.0.0.0" | Hostname to bind to |

wrapAgent(graph, name)

Wrap a LangGraph compiled graph for use with Reminix Runtime. Use this with serve from @reminix/runtime for multi-agent setups.

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

Returns: LangGraphAgentAdapter - 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

Execute the graph. Input keys are passed directly to the graph.

Request:

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

Response:

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

Streaming

For streaming responses, set stream: true in the request:

{
  "messages": [{"role": "user", "content": "Hello!"}],
  "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

• GitHub Repository
• LangGraph.js Documentation

License

Apache-2.0