elizaos-plugin-anthropic

Python implementation of the Anthropic Claude API client for elizaOS.

Features

• Text generation with Claude models
• Structured JSON object generation
• Strong types with Pydantic models
• Fail-fast error handling
• Async/await support with httpx

Installation

pip install elizaos-plugin-anthropic

Usage

Text Generation

import asyncio
from elizaos_plugin_anthropic import AnthropicClient, AnthropicConfig, TextGenerationParams

async def main():
    config = AnthropicConfig.from_env()
    async with AnthropicClient(config) as client:
        # Simple prompt
        response = await client.generate_text_large("What is the meaning of life?")
        print(f"Response: {response.text}")

        # With parameters
        params = (
            TextGenerationParams(prompt="Explain quantum computing")
            .with_max_tokens(1024)
            .with_temperature(0.7)
        )
        response = await client.generate_text_large(params)
        print(f"Tokens used: {response.usage.total_tokens()}")

asyncio.run(main())

JSON Object Generation

import asyncio
from elizaos_plugin_anthropic import AnthropicClient, AnthropicConfig, ObjectGenerationParams

async def main():
    config = AnthropicConfig.from_env()
    async with AnthropicClient(config) as client:
        # Simple prompt
        response = await client.generate_object_small(
            "Create a JSON object with name, age, and email fields"
        )
        print(f"Generated: {response.object}")

        # With parameters
        params = ObjectGenerationParams(
            prompt="Create a user profile with nested address",
            temperature=0.2,
        )
        response = await client.generate_object_large(params)
        print(f"User: {response.object}")

asyncio.run(main())

Configuration

Environment variables:

Models

Available models:

Testing

Install development dependencies:

pip install -e ".[dev]"

Run unit tests:

pytest -v

Run integration tests (requires API key):

# Create .env file with your API key
echo "ANTHROPIC_API_KEY=your-key" > .env

# Run integration tests
pytest -m integration

Type Checking

mypy elizaos_plugin_anthropic

License

MIT