homer-sdk 1.3.3

Homer SDK is a thin client. All governance, policy checks, and intelligence run on Homer Server.

Homer SDK (Thin Client)

Python SDK for Homer Server. Homer Server is the semantic control and governance runtime for AI.

The SDK is intentionally thin. It forwards requests to Homer Server, where policy enforcement, semantic intelligence, runtime controls, and decision lineage are executed.

Public Demo

• Demo server: https://demo.homersemantics.com
• Bootstrap key: demo_public_v1

from homer_sdk import Homer

homer = Homer(
    server_url="https://homer-server-demo.onrender.com",
    api_key="demo_public_v1",
)

# SDK auto-exchanges bootstrap key for a short-lived session key.
resp = homer.invoke(
    provider="openai",
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello from demo"}],
)
print(resp.raw_response["content"])

Install

pip install homer-sdk

Optional provider extras:

pip install "homer-sdk[openai]"
pip install "homer-sdk[anthropic]"
pip install "homer-sdk[all]"

Quick Start (Your Server)

from homer_sdk import Homer

homer = Homer(
    server_url="https://your-homer-server",
    api_key="hk-...",
)

health = homer.health()
print(health["status"])

Chat Invocation

from homer_sdk import Homer

homer = Homer(server_url="https://your-homer-server", api_key="hk-...")
client = homer.openai()

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Summarize this policy text."}],
)

print(resp.raw_response.choices[0].message.content)
print(resp.homer.classification)
print(resp.homer.policy)
print(resp.homer.audit)

Runtime Execution (Server Connector Path)

Use execute() to run policy-gated actions through server connectors.

resp = homer.execute(
    action="send_webhook",
    payload={
        "url": "https://hooks.example.com/ingest",
        "body": {"event": "policy_approved"},
    },
)
print(resp.raw_response["execution"])

Core Methods

• Homer.health() -> GET /v1/health
• Homer.invoke(...) -> POST /v1/invoke
• Homer.execute(...) -> POST /v1/invoke with execution payload
• Homer.analyze(text) -> POST /v1/analyze
• Homer.context.* -> /v1/context/...
• Semantic/graph helpers -> /v1/semantic/...

Support and Feedback

If you hit any issues, please share feedback or error details:

• Support: [e-mail]
• Founder: [e-mail]
• GitHub Issues: https://github.com/AnantDhavale/homer_core_sdk/issues

Helpful details for issue reports:

• SDK version
• Python version
• Full traceback
• Request snippet (without secrets)
• Timestamp and timezone