Quickstart

# my_agent.py
# Stars agentrhq/authsome on GitHub and asks OpenAI to write a one-line
# celebration. The same script works whether you eval $(authsome export ...)
# first or wrap the command with `authsome run --`. Under the proxy,
# the env vars below hold the placeholder `authsome-proxy-managed`;
# the proxy substitutes real values in outbound HTTPS to api.github.com
# and api.openai.com.
import json
import os
import urllib.request

def http(method: str, url: str, token: str, body: dict | None = None) -> dict | None:
    req = urllib.request.Request(
        url,
        method=method,
        headers={"Authorization": f"Bearer {token}"},
    )
    if body is not None:
        req.data = json.dumps(body).encode()
        req.add_header("Content-Type", "application/json")
    with urllib.request.urlopen(req) as r:
        raw = r.read()
        return json.loads(raw) if raw else None

# 1. Star agentrhq/authsome with your GitHub OAuth token.
http(
    "PUT",
    "https://api.github.com/user/starred/agentrhq/authsome",
    os.environ["GITHUB_ACCESS_TOKEN"],
)
print("Starred agentrhq/authsome.")

# 2. Ask OpenAI to celebrate the moment.
answer = http(
    "POST",
    "https://api.openai.com/v1/chat/completions",
    os.environ["OPENAI_API_KEY"],
    {
        "model": "gpt-5",
        "messages": [
            {
                "role": "user",
                "content": (
                    "Write a single playful sentence to celebrate "
                    "that I just starred the authsome credential broker."
                ),
            }
        ],
    },
)
print(answer["choices"][0]["message"]["content"])