@reminix/adapters

Framework adapters for the Reminix Agent Runtime. Easily wrap popular AI frameworks as Reminix agents.

Installation

npm install @reminix/adapters @reminix/runtime
# or
pnpm add @reminix/adapters @reminix/runtime
Copy

You'll also need to install the framework(s) you want to use:

# For OpenAI
npm install openai

# For Anthropic
npm install @anthropic-ai/sdk

# For LangChain
npm install @langchain/core

# For LangGraph
npm install @langchain/langgraph

# For Vercel AI SDK
npm install ai
Copy

Usage

OpenAI

import OpenAI from 'openai';
import { fromOpenAI } from '@reminix/adapters/openai';
import { serve } from '@reminix/runtime';

const client = new OpenAI();
const agent = fromOpenAI(client, {
  name: 'gpt4-agent',
  model: 'gpt-4o',
  system: 'You are a helpful assistant.',
});

serve(agent);
Copy

Anthropic

import Anthropic from '@anthropic-ai/sdk';
import { fromAnthropic } from '@reminix/adapters/anthropic';
import { serve } from '@reminix/runtime';

const client = new Anthropic();
const agent = fromAnthropic(client, {
  name: 'claude-agent',
  model: 'claude-sonnet-4-20250514',
  system: 'You are a helpful assistant.',
});

serve(agent);
Copy

LangChain

import { ChatOpenAI } from '@langchain/openai';
import { fromLangChainChatModel } from '@reminix/adapters/langchain';
import { serve } from '@reminix/runtime';

const model = new ChatOpenAI({ model: 'gpt-4o' });
const agent = fromLangChainChatModel(model, { name: 'langchain-agent' });

serve(agent);
Copy

LangChain Agent (Modern API)

import { createAgent } from 'langchain';
import { fromLangChainAgent } from '@reminix/adapters/langchain';
import { serve } from '@reminix/runtime';

const lcAgent = createAgent({
  model: 'openai:gpt-4o',
  tools: [searchTool, calculatorTool],
});

const agent = fromLangChainAgent(lcAgent, { name: 'smart-agent' });

serve(agent);
Copy

LangGraph

import { StateGraph, MessagesAnnotation } from '@langchain/langgraph';
import { fromCompiledGraph } from '@reminix/adapters/langgraph';
import { serve } from '@reminix/runtime';

const graph = new StateGraph(MessagesAnnotation)
  .addNode('agent', async (state) => {
    // ... your agent logic
  })
  .addEdge('__start__', 'agent')
  .addEdge('agent', '__end__')
  .compile();

const agent = fromCompiledGraph(graph, { name: 'langgraph-agent' });

serve(agent);
Copy

Vercel AI SDK

import { openai } from '@ai-sdk/openai';
import { fromGenerateText } from '@reminix/adapters/vercel-ai';
import { serve } from '@reminix/runtime';

const agent = fromGenerateText({
  name: 'vercel-agent',
  model: openai('gpt-4o'),
  system: 'You are a helpful assistant.',
});

serve(agent);
Copy

Available Adapters

Peer Dependencies

This package uses optional peer dependencies. You only need to install the frameworks you actually use:

Testing

Unit Tests

pnpm test
Copy

Integration Tests

Integration tests verify adapters work with real LLM APIs. See tests/integration/README.md for details.

# Run specific adapter tests
OPENAI_API_KEY=sk-... pnpm test:integration:openai
ANTHROPIC_API_KEY=sk-ant-... pnpm test:integration:anthropic
Copy

License

MIT