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
Signature and schema smoke
Commandnpm run example -- python signature_schema.py
Env
None
provider_mapping_no_key.py
OpenAI-compatible mapping smoke
Commandnpm run example -- python provider_mapping_no_key.py
Env
None
provider_stream_no_key.py
OpenAI-compatible streaming smoke
Commandnpm run example -- python provider_stream_no_key.py
Env
None
Provider API examples
axgen_openai_api.py
AxGen OpenAI API run
Commandnpm run example -- python axgen_openai_api.py
EnvOPENAI_API_KEY, OPENAI_APIKEY
agent_openai_api.py
AxAgent OpenAI API run
Commandnpm run example -- python agent_openai_api.py
EnvOPENAI_API_KEY, OPENAI_APIKEY
flow_openai_api.py
AxFlow OpenAI API run
Commandnpm run example -- python flow_openai_api.py
EnvOPENAI_API_KEY, OPENAI_APIKEY
LLM, media, and realtime examples
audio_responses_mapping.py
OpenAI Responses audio mapping
Commandnpm run example -- python audio_responses_mapping.py
Env
None
realtime_audio_events.py
Grok and Gemini realtime event folding
Commandnpm run example -- python realtime_audio_events.py
Env
None
Agent and RLM examples
axagent_pipeline.py
Deterministic AxAgent forward and logs
Commandnpm run example -- python axagent_pipeline.py
Env
None
runtime_adapter.py
Custom AxCodeRuntime session
Commandnpm run example -- python runtime_adapter.py
Env
None
mcp_scripted_tools.py
MCP scripted transport tools
Commandnpm run example -- python mcp_scripted_tools.py
Env
None
Flow examples
axflow_program_graph.py
Deterministic AxFlow graph
Commandnpm run example -- python axflow_program_graph.py
Env
None
Optimization examples
optimizer_artifact.py
Optimizer artifact apply round trip
Commandnpm run example -- python optimizer_artifact.py
Env
None
gepa_local_optimizer.py
Local GEPA engine run
Commandnpm run example -- python gepa_local_optimizer.py
Env
None
Other examples
axgen_scripted_client_tool.py
AxGen scripted client and tool
Commandnpm run example -- python axgen_scripted_client_tool.py
Env
None
How To Read These
No keyexamples use scripted clients, protocol adapters, or generated package tests.Provider APIexamples make real HTTP calls and list the environment variables they normally need.- Generated language examples live under each package’s
examplesdirectory. - TypeScript examples live under
src/examples.
Source
- Catalog:
npm run example -- list/scripts/run-example.mjs - Files:
packages/python/examples