samples/openai-agents-sdk_1 — awesome-ai-stack

Example

OpenAI Agents SDK — implementation sample

A real, runnable mini-project. Download it and run with Docker.

View samples/openai-agents-sdk_1 on GitHub ↗

June 28, 2026

OpenAI Agents SDK — implementation sample

A tiny OpenAI Agents SDK sample: it defines an agent and runs your prompt.

Configure

cd samples/openai-agents-sdk_1
cp .env.sample .env
# edit .env: set OPENAI_API_KEY (and optionally MODEL)

Run with Docker

cd samples/openai-agents-sdk_1
docker build -t aas-openai-agents .
docker run --rm --env-file .env aas-openai-agents "Summarize AI agents in one sentence."

Run with Docker (in a devcontainer with DooD)

The foreground docker run may print nothing under Docker-outside-of-Docker — run detached and follow the logs:

docker logs -f "$(docker run -d --env-file .env aas-openai-agents "Summarize AI agents in one sentence.")"

Run locally

cd samples/openai-agents-sdk_1
pip install -r requirements.txt
python app.py "Summarize AI agents in one sentence."

Example run

Output varies by model and run — LLMs are non-deterministic. One run with gpt-4o-mini:

An AI agent is an autonomous system that perceives its environment, makes decisions based on that information, and acts to achieve specific goals.

.env.sample

# Copy to `.env` and add your OpenAI API key.
#   cp .env.sample .env
OPENAI_API_KEY=

MODEL=gpt-4o-mini

app.py

"""OpenAI Agents SDK: define an agent and run it.

Run:
    docker build -t aas-openai-agents .
    docker run --rm --env-file .env aas-openai-agents "Summarize AI agents in one sentence."
"""

import os
import sys

from dotenv import load_dotenv
from agents import Agent, Runner

load_dotenv()

MODEL = os.environ.get("MODEL", "gpt-4o-mini")


def main() -> None:
    prompt = " ".join(sys.argv[1:]) or "Summarize what an AI agent is in one sentence."
    agent = Agent(name="Assistant", instructions="You are concise and helpful.", model=MODEL)
    print(Runner.run_sync(agent, prompt).final_output)


if __name__ == "__main__":
    main()

Dockerfile

FROM python:3.13-slim

ENV PYTHONUNBUFFERED=1

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY app.py .

ENTRYPOINT ["python", "app.py"]