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 URL
ATHENA_DOCX_API_KEY — Athena API key or service-issued DOCX Studio token

License

MIT

Metadata

Release files for athena-python-docx 0.22.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for athena-python-docx 0.22.0
File	Size	Uploaded
athena_python_docx-0.22.0.tar.gz	809.9 kB	Oct 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for athena-python-docx 0.22.0
File	Interpreter	ABI	Platform	Reset
athena_python_docx-0.22.0-py3-none-any.whl 290.8 kB Oct 8, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / athena_python_docx-0.22.0.tar.gz

Download URL	athena_python_docx-0.22.0.tar.gz
Size	809.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`994a2094f4ac55d581e6c3217551d50b02cb3988baa8e877fea438bef7f66dc4`
BLAKE2b-256 checksum How to use checksums	`d478b1c3b50c4f92fb7a7acdfbf5a870820906f2d8d0b5fe40a8b9c6471d96ec`
Upload date	Oct 8, 2026
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.22.0-py3-none-any.whl

Download URL	athena_python_docx-0.22.0-py3-none-any.whl
Size	290.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1edbef7dde31a10a140b586a9eea1e4b3722d40b2584e01094e1211d86171958`
BLAKE2b-256 checksum How to use checksums	`b35da9d04c2f6ce4a054b75143a625e58ff40471286d0cec0a8312f8dd993b24`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`