ironlabs 0.1.0

IronLabs Python SDK — intelligent LLM routing

API vs SDK

• Client side LLM invocation.
  • Our API endpoint of model-router, only recommends the model to use.
  • The sdk invokes the "recommended model" for the given prompt, gets the response back.

SDK also provides the following features which API endpoint doesn't via a common interface.

Features:

• Model routing functionality using the IronaAI API endpoints
• [] Support for async & sync requests of LLM-invocation.
• Function calling,
• Tool binding using LiteLLM's function calling capabilities
• Error handling and retries
• Support for streaming,
• and JSON mode (i.e. structured output)
• [] Detailed latency tracking and reporting - TBD
• [] Creation of preference IDs - TBD

• Retry logic (invocation or model-router)
• Unified Interface
• Tool binding

Install:

pip install ironlabs

Migrating from ironaai? The package was renamed to ironlabs in v0.1.0. Update your pip install and from ironlabs import …. Your existing API key keeps working — the SDK accepts both IRONLABS_API_KEY (preferred) and IRONAAI_API_KEY for the migration window.

Export keys for provider you will use:

IRONLABS_API_KEY = "YOUR_IRONLABS_API_KEY"
OPENAI_API_KEY = "YOUR_OPENAI_API_KEY"
ANTHROPIC_API_KEY = "YOUR_ANTHROPIC_API_KEY"

To use this client, you would initialize it like this:

client = IronaAI(
    model_list=["openai/gpt-3.5-turbo", "openai/gpt-4", "anthropic/claude-2"],
)

You can then use it for completions, function calling, and tool binding:

# Regular completion
response = client.completions.create(
    messages=[{"role": "user", "content": "Hello, how are you?"}],
    model_list=["openai/gpt-3.5-turbo", "openai/gpt-4", "anthropic/claude-2"],)

# Function calling
def get_current_weather(location: str, unit: str = "fahrenheit"):
    """Get the current weather in a given location"""
    # Implementation here
    return f"The weather in {location} is 72°F."

tools = [
    {
        "name": "get_current_weather",
        "description": "Get the current weather in a given location",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {"type": "string"},
                "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
            },
            "required": ["location"],
        },
    }
]

messages = [{"role": "user", "content": "What's the weather like in San Francisco?"}]

# Call the model
response = client.completions.create( messages=messages, tools=tools, tool_choice="auto",)

Install Instructions

poetry install .

Push this to PyPi

poetry build
poetry publish

Then users can simply install the package using pip:

pip install ironlabs