Skip to content

examples: add quickstart.py for basic OzAPI usage#35

Draft
kjankov wants to merge 1 commit into
mainfrom
oz/add-quickstart-example
Draft

examples: add quickstart.py for basic OzAPI usage#35
kjankov wants to merge 1 commit into
mainfrom
oz/add-quickstart-example

Conversation

@kjankov

@kjankov kjankov commented Jun 18, 2026

Copy link
Copy Markdown

Summary

Adds a minimal, self-contained quickstart example to examples/quickstart.py. It shows the two-line setup needed to instantiate OzAPI and dispatch a simple agent task — useful as a copy-paste starting point.

Change

  • New file: examples/quickstart.py — a runnable script (shebang: #!/usr/bin/env -S uv run python) that demonstrates client.agent.run() with a short prompt and prints the resulting run_id.
  • No production or generated code is touched; examples/ is a manually maintained directory that the generator never overwrites.

Testing

Formatter (ruff format --check + ruff check) and model tests (pytest tests/test_models.py) both pass:

58 passed in 1.15s

Screenshot

Test run and quickstart.py

Conversation: http://localhost:8080/conversation/e1b9f234-e03e-4132-a38f-15a244159e54
Run: http://localhost:8082/runs/019edcb0-2ddd-7b71-ac0b-e11781e68779

This PR was generated with Oz.

Adds a minimal runnable example showing how to instantiate the
OzAPI client and dispatch a simple agent task. This lives in the
examples/ directory (manually maintained, never overwritten by the
generator).

Co-Authored-By: Oz <oz-agent@warp.dev>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant