reminix-anthropic 0.0.12

Reminix adapter for Anthropic - serve agents as REST APIs

reminix-anthropic

Reminix Runtime adapter for the Anthropic API. Serve Claude models 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-anthropic

This will also install reminix-runtime as a dependency.

Quick Start

from anthropic import AsyncAnthropic
from reminix_anthropic import serve_agent

client = AsyncAnthropic()
serve_agent(client, name="my-claude", model="claude-sonnet-4-20250514", port=8080)

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

from anthropic import AsyncAnthropic
from reminix_anthropic import wrap_agent
from reminix_runtime import serve

client = AsyncAnthropic()
agent = wrap_agent(client, name="my-claude", model="claude-sonnet-4-20250514")
serve(agents=[agent], port=8080)

Your agent is now available at:

• POST /agents/my-claude/execute - Execute the agent

API Reference

serve_agent(client, name, model, max_tokens, port, host)

Wrap an Anthropic client and serve it immediately. Combines wrap_agent and serve for single-agent setups.

Parameter	Type	Default	Description
client	AsyncAnthropic	required	An Anthropic async client
name	str	"anthropic-agent"	Name for the agent (used in URL path)
model	str	"claude-sonnet-4-20250514"	Model to use
max_tokens	int	4096	Maximum tokens in response
port	int	8080	Port to serve on
host	str	"0.0.0.0"	Host to bind to

wrap_agent(client, name, model, max_tokens)

Wrap an Anthropic client for use with Reminix Runtime. Use this with serve from reminix_runtime for multi-agent setups.

Parameter	Type	Default	Description
client	AsyncAnthropic	required	An Anthropic async client
name	str	"anthropic-agent"	Name for the agent (used in URL path)
model	str	"claude-sonnet-4-20250514"	Model to use
max_tokens	int	4096	Maximum tokens in response

Returns: AnthropicAgentAdapter - A Reminix adapter instance

System Messages

The adapter automatically handles Anthropic's system message format. System messages in your request are extracted and passed as the system parameter to the API.

# This works automatically:
request = {
    "messages": [
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "Hello!"}
    ]
}

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": "system", "content": "You are a helpful assistant."},
    {"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

• GitHub Repository
• Anthropic Documentation

License

Apache-2.0