oxa — Python Reference Implementation
Pure, in-process protocol-conversion library for OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages in Python.
Like the Go and Rust implementations, oxa in Python is not a proxy, HTTP client, router, retry layer, authentication service, or model capability database. It provides deterministic, pure conversions between protocol wire structures and oxa's shared Intermediate Representation (IR).
Architecture
- Hub-and-spoke: Spoke packages (
oxa.openai.chatcompletions,oxa.openai.responses,oxa.anthropic.messages) implement onlyface → IRandIR → face. No direct face-to-face conversions. - Zero runtime dependencies: Pure Python standard library only
(
dataclasses,typing,json,enum, etc.). - Opaque tool inputs (INV-1): Tool call arguments and streaming delta fragments remain unparsed raw JSON text.
- Shared Golden Vectors: Conforms to the exact same shared
vectors/golden suite as Go and Rust.
Installation
pip install elkpi-oxa
Import in Python:
import oxa
from oxa.openai.chatcompletions import decode_request
Development
The project uses uv for development and
environment management:
cd python
# Sync virtualenv and development dependencies
uv sync
# Run tests
uv run pytest
# Type check
uv run mypy
# Lint & format check
uv run ruff check .
uv run ruff format --check .
Vectors Location Convention
Test harnesses locate the shared vectors/ suite by walking up parent
directories from python/ until finding a directory containing both vectors/
and .git/. Tests skip cleanly if the repository root is absent (e.g. when
building a standalone package archive).
原始 JSON 入口
各 face 导出 decode_request_json(raw_text, table=None) /
decode_response_json(raw_text, table=None)；stream decoder 支持 feed_json(raw_text)。
旧 dict 接口仍可用；若同时提供 raw_text，它必须对应该 dict。参数原文按完整对象/数组
路径提取，不再通过 tool ID 的字符串位置关联。空 loss 列表不是业务准入证明。
1 maintainer
Metadata
1 maintainer
Release files for elkpi-oxa 2.4.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| elkpi_oxa-2.4.11.tar.gz | 119.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| elkpi_oxa-2.4.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 236.1 kB
Release files / elkpi_oxa-2.4.11.tar.gz
| Download URL | elkpi_oxa-2.4.11.tar.gz |
|---|---|
| Size | 119.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e71e16a059c9894f4ce2097ef6bb1c16742718630ff5d10d1898c71524a113bc
|
|
BLAKE2b-256 checksum How to use checksums |
d97a240f0956bbd30cafcbb6acf2c549a44382c79896cde1a4be2955d6e97140
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / elkpi_oxa-2.4.11-py3-none-any.whl
| Download URL | elkpi_oxa-2.4.11-py3-none-any.whl |
|---|---|
| Size | 116.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ada0d674109f1e10a5fefa25174bb604e85c414a386d45804ea49826878197b6
|
|
BLAKE2b-256 checksum How to use checksums |
f14a419d255819feea0b79e61c19937001bede6c4aa322e67d9f8f6667ee5e3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for elkpi-oxa 2.4.11
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
