Skip to main content

Reminix adapter for Anthropic - serve agents as REST APIs

Project description

reminix-anthropic

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

This will also install reminix-runtime as a dependency.

Quick Start

from anthropic import AsyncAnthropic
from reminix_anthropic import wrap
from reminix_runtime import serve

# Create an Anthropic client
client = AsyncAnthropic()

# Wrap it with the Reminix adapter
agent = wrap(client, name="my-claude", model="claude-sonnet-4-20250514")

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

Your agent is now available at:

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

API Reference

wrap(client, name, model, max_tokens)

Wrap an Anthropic client for use with Reminix Runtime.

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: AnthropicAdapter - 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}/invoke

Stateless invocation for task-oriented operations.

Request:

{
  "input": {
    "prompt": "Summarize this text: ..."
  }
}

Or with messages:

{
  "input": {
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"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": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

Response:

{
  "output": "The capital of France is Paris.",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"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_anthropic-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_anthropic-0.0.2-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: reminix_anthropic-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_anthropic-0.0.2.tar.gz
Algorithm Hash digest
SHA256 85dc6eb172403e968eafbf26e69d009535a75a8673217fe41d75eea41df60a47
MD5 380f7564f3dffc96daf2f485ffdaeb3a
BLAKE2b-256 193902da1a3635c9c296d47d50e47bf28bb903f86558760fad12615f23536b51

See more details on using hashes here.

File details

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

File metadata

  • Download URL: reminix_anthropic-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 4.9 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_anthropic-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5d4ea40474c27cd251d02237f1e5caa29b1f765b457b00c4665a51c9673fc7d8
MD5 2da315ee4d11e63a3a3e1061d9205796
BLAKE2b-256 25bcfe7dba3c7c3769dd3248f5cf45038c8f2e88fdf3c0ca4b852026f2f9db25

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