Python SDK Overview

pip install rail-score-sdk

pip install "rail-score-sdk[openai]"       # OpenAI wrapper
pip install "rail-score-sdk[anthropic]"    # Anthropic wrapper
pip install "rail-score-sdk[google]"       # Gemini wrapper
pip install "rail-score-sdk[litellm]"      # LiteLLM wrapper
pip install "rail-score-sdk[integrations]" # All model providers
pip install "rail-score-sdk[agents]"       # CrewAI, LangGraph, AutoGen
pip install "rail-score-sdk[telemetry]"    # OpenTelemetry support
pip install "rail-score-sdk[dev]"          # Development tools

from rail_score_sdk import RailScoreClient

client = RailScoreClient(api_key="YOUR_RAIL_API_KEY")

result = client.eval(content="Your AI-generated text here", mode="basic")
print(f"RAIL Score: {result.rail_score.score}/10")

import asyncio
from rail_score_sdk import AsyncRAILClient

async def main():
    client = AsyncRAILClient(api_key="YOUR_RAIL_API_KEY")
    result = await client.eval(content="Your text here", mode="basic")
    print(result["rail_score"]["score"])  # Returns raw dicts

asyncio.run(main())

from rail_score_sdk import (
    RailScoreClient,
    AuthenticationError,
    InsufficientCreditsError,
    RateLimitError,
    ContentTooHarmfulError,
    DPDPHostedOnlyError,
)

client = RailScoreClient(api_key="YOUR_RAIL_API_KEY")

try:
    result = client.eval(content="...", mode="deep")
except AuthenticationError:
    print("Check your API key")
except InsufficientCreditsError:
    print("Account limit reached")
except RateLimitError:
    print("Slow down requests")
except ContentTooHarmfulError:
    print("Content blocked at safety layer")
except DPDPHostedOnlyError:
    print("DPDP audit runs against the hosted API only")