athena-python-docx
Drop-in replacement for python-docx that connects to Athena's Keryx-backed Word document stack.
Quick start
from docx import Document
from docx.shared import Inches, Pt, RGBColor
# Open an existing Word document asset by its Athena asset_id
with Document("asset_abc123") as doc:
doc.add_heading("Market Analysis", level=1)
p = doc.add_paragraph()
r = p.add_run("Revenue grew ")
highlight = p.add_run("12.3% year-over-year")
highlight.bold = True
highlight.font.color.rgb = RGBColor(0x00, 0x80, 0x00)
p.add_run(".")
t = doc.add_table(rows=2, cols=2, style="TableGrid")
t.cell(0, 0).text = "Segment"
t.cell(0, 1).text = "Revenue"
t.cell(1, 0).text = "Enterprise"
t.cell(1, 1).text = "$4.3M"
doc.save()
API parity rule
This SDK mirrors python-docx's public API exactly. See CLAUDE.md for the full contract.
Development
uv venv
uv pip install -e ".[dev]"
uv run pytest tests/ -x
DocX Execution Lab
For fast local repros against real Athena document assets, use the
headless runner in scripts/docx_exec_lab.py. It executes an arbitrary
Python snippet with this checkout of athena-python-docx, captures
stdout/stderr/errors/timings, and can export the resulting .docx for
text assertions. scripts/docx_exec_lab_server.py adds a local UI with
an Olympus Word document embed preview pane. See DOCX_EXEC_LAB.md.
Environment variables
Required when connecting to DOCX Studio (set by the Athena backend in the execute_word_document_code executor sandbox):
ATHENA_DOCX_BASE_URL— DOCX Studio API base URLATHENA_DOCX_API_KEY— Athena API key or service-issued DOCX Studio token
License
MIT
Metadata
Release files for athena-python-docx 0.40.0
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 | |
|---|---|---|---|---|
| athena_python_docx-0.40.0.tar.gz | 1.2 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| athena_python_docx-0.40.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / athena_python_docx-0.40.0.tar.gz
| Download URL | athena_python_docx-0.40.0.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
76a6c3a1497baf8f8a9d28d92825b68d9b10a60effd7ed4d11b6b855e4f8cf2b
|
|
BLAKE2b-256 checksum How to use checksums |
245bce52f265fbb1ced256d41a0d726dda62f961abe7876e1d57c69d52875443
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / athena_python_docx-0.40.0-py3-none-any.whl
| Download URL | athena_python_docx-0.40.0-py3-none-any.whl |
|---|---|
| Size | 417.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
504e88f5f7acc1ae825bf844d16f137931b375988e99086d5e12c7d14df4ff4e
|
|
BLAKE2b-256 checksum How to use checksums |
d0cac2156ddc585765b423c85291c9590ed22ee4415a964eabfad3160a74fc47
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Security for athena-python-docx 0.40.0
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.
