semantic-eq 1.0.0

Python SDK for Semantic Equivalence API - optimize prompts for semantic equivalence

Semantic EQ SDK

Python SDK for the Semantic Equivalence API - optimize prompts for semantic equivalence.

Installation

pip install semantic-eq

Quick Start

from semantic_eq_sdk import SemanticEQClient

# Initialize the client
client = SemanticEQClient(
    base_url="https://api.semantic-eq.com",  # or your deployed URL
    api_key="your-api-key"  # optional
)

# Optimize a prompt
result = client.optimize_prompt("Write a compelling email subject line for our product launch")

print(f"Original: {result.original_prompt}")
print(f"Optimized: {result.optimized_prompt}")
if result.improvement_score:
    print(f"Improvement score: {result.improvement_score}")

API Reference

SemanticEQClient

Initialize the client with your API endpoint:

client = SemanticEQClient(
    base_url="http://localhost:8001",  # Your API URL
    api_key="optional-api-key"        # Optional authentication
)

optimize_prompt(prompt)

Optimize a single prompt for better semantic equivalence.

Parameters:

• prompt (str): The prompt text to optimize

Returns:

• OptimizationResult: Contains original and optimized prompt

Example:

result = client.optimize_prompt("Your prompt here")
print(result.optimized_prompt)

health_check()

Check if the API is healthy and accessible.

Returns:

• dict: Health status information

Example:

health = client.health_check()
print(f"API Status: {health['status']}")

Response Objects

OptimizationResult

The result of a prompt optimization:

@dataclass
class OptimizationResult:
    original_prompt: str           # The original prompt
    optimized_prompt: str          # The optimized version
    improvement_score: float       # Optional improvement score (0-1)

Error Handling

from semantic_eq_sdk import SemanticEQError, OptimizationError

try:
    result = client.optimize_prompt("Your prompt")
    print(result.optimized_prompt)
except OptimizationError as e:
    print(f"Optimization failed: {e}")
except SemanticEQError as e:
    print(f"SDK error: {e}")
except Exception as e:
    print(f"Unexpected error: {e}")

API Endpoints

This SDK expects your API to have these endpoints:

• POST /optimize - Optimize a prompt

  // Request
  {"prompt": "Your prompt text"}
  
  // Response
  {
    "original_prompt": "Your prompt text",
    "optimized_prompt": "Optimized version",
    "improvement_score": 0.85
  }
  

• GET /health - Health check

  // Response
  {"status": "healthy"}
  

Development

Running Tests

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest test/

Code Style

# Format code
black src/

# Lint code  
flake8 src/

License

MIT License - see LICENSE file for details.