Examples Runnable no-key and provider-api examples. python examples examples website/content-src/templates/examples.md example Examples

Examples

Examples are grouped by what they prove and by whether they need real provider credentials. Start with no-key examples for deterministic protocol, runtime, and generated-package behavior. Use provider-api examples when you want the live provider request path.

Quick no-key starters

signature_schema.py

No key Python

Signature and schema smoke

Command
npm run example -- python signature_schema.py

Env
None

provider_mapping_no_key.py

No key Python

OpenAI-compatible mapping smoke

Command
npm run example -- python provider_mapping_no_key.py

Env
None

provider_stream_no_key.py

No key Python

OpenAI-compatible streaming smoke

Command
npm run example -- python provider_stream_no_key.py

Env
None

Provider API examples

axgen_openai_api.py

Provider API Python

AxGen OpenAI API run

Command
npm run example -- python axgen_openai_api.py

Env
OPENAI_API_KEY, OPENAI_APIKEY

agent_openai_api.py

Provider API Python

AxAgent OpenAI API run

Command
npm run example -- python agent_openai_api.py

Env
OPENAI_API_KEY, OPENAI_APIKEY

flow_openai_api.py

Provider API Python

AxFlow OpenAI API run

Command
npm run example -- python flow_openai_api.py

Env
OPENAI_API_KEY, OPENAI_APIKEY

LLM, media, and realtime examples

audio_responses_mapping.py

No key Python

OpenAI Responses audio mapping

Command
npm run example -- python audio_responses_mapping.py

Env
None

realtime_audio_events.py

No key Python

Grok and Gemini realtime event folding

Command
npm run example -- python realtime_audio_events.py

Env
None

Agent and RLM examples

axagent_pipeline.py

No key Python

Deterministic AxAgent forward and logs

Command
npm run example -- python axagent_pipeline.py

Env
None

runtime_adapter.py

No key Python

Custom AxCodeRuntime session

Command
npm run example -- python runtime_adapter.py

Env
None

mcp_scripted_tools.py

No key Python

MCP scripted transport tools

Command
npm run example -- python mcp_scripted_tools.py

Env
None

Flow examples

axflow_program_graph.py

No key Python

Deterministic AxFlow graph

Command
npm run example -- python axflow_program_graph.py

Env
None

Optimization examples

optimizer_artifact.py

No key Python

Optimizer artifact apply round trip

Command
npm run example -- python optimizer_artifact.py

Env
None

gepa_local_optimizer.py

No key Python

Local GEPA engine run

Command
npm run example -- python gepa_local_optimizer.py

Env
None

Other examples

axgen_scripted_client_tool.py

No key Python

AxGen scripted client and tool

Command
npm run example -- python axgen_scripted_client_tool.py

Env
None

How To Read These

  • No key examples use scripted clients, protocol adapters, or generated package tests.
  • Provider API examples make real HTTP calls and list the environment variables they normally need.
  • Generated language examples live under each package’s examples directory.
  • TypeScript examples live under src/examples.

Source

  • Catalog: npm run example -- list / scripts/run-example.mjs
  • Files: packages/python/examples
Docs