Quick Start

import openai
from hexr import hexr_agent, hexr_tool, hexr_llm
from hexr.vault import VaultClient

@hexr_agent(name="my-first-agent", tenant="my-team")
def main():
    # Fetch API key from Hexr Vault (no secrets in code)
    vault = VaultClient()
    api_key = vault.get("api-keys/openai")

    # Wrap the OpenAI client — automatic OTel tracing on every call
    client = hexr_llm(openai.OpenAI(api_key=api_key))

    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[{"role": "user", "content": "What is the capital of France?"}],
    )
    print(response.choices[0].message.content)

    # Get an authenticated S3 client via SPIFFE identity (no AWS keys)
    s3 = hexr_tool("aws_s3")
    buckets = s3.list_buckets()
    print(f"Found {len(buckets['Buckets'])} buckets")

if __name__ == "__main__":
    main()

$ hexr build my_agent.py --tenant my-team

Analyzing my_agent.py...
  Framework: pure_python
  Agents: 1 (my-first-agent)
  Resources: aws_s3
  A2A: disabled

Generated .hexr/ (5 files)

$ hexr push

Building for: linux/amd64, linux/arm64
Pushing to: registry/my-team/my-first-agent:latest

✓ Image pushed
✓ Vulnerability scan: 0 critical

$ hexr deploy

Applying manifests to tenant-my-team...
  ✓ Namespace created
  ✓ RBAC applied
  ✓ Agent pod created (4/4 containers)

Agent deployed!
  SPIFFE ID: spiffe://demo.hexr.dev/agent/my-team/my-first-agent/main