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.

Note: CLI entrypoint issues were fixed in v1.3.4. If you tried earlier and saw errors, please upgrade and try again.

python3 -m pip install -U homer-sdk
homer-sdk --version

Public Demo

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

from homer_sdk import Homer

homer = Homer(
    server_url="https://demo.homersemantics.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

Verify CLI install:

homer-sdk --version

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: info@homersemantics.com
• Founder: anantdhavale@gmail.com
• 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