---
id: pyhwpx
version: "1.7.2"
license: unclear
license_treatment: unclear
maintenance: active
---

# pyhwpx — 아래아한글 자동화를 위한 파이썬 모듈 pyhwpx입니다.

License: unclear · Maintenance: active · Downloads: 420.0K/mo

## What it is and what it does

pyhwpx is a Python wrapper around the HwpAutomation COM interface, exposing HWP (아래아한글, the Korean word processor) document operations through a more convenient API than raw win32com calls. It lets you programmatically create, edit, and save HWP documents from Python code—inserting text, executing HwpAutomation commands, and persisting changes to disk.

The package is Windows-only and requires the HWP application to be installed on the system. It depends on pywin32 to communicate with the COM interface, plus numpy, pandas, openpyxl, pyperclip, and Pillow for supporting operations. The maintainers are actively adding convenience methods and higher-level patterns for common document-automation tasks, though the library still exposes lower-level HwpAutomation API calls for advanced use.

Use it for:

- Batch-generate HWP documents from templates or data sources in a Python workflow.
- Automate repetitive HWP editing tasks (text insertion, formatting, saving) without manual intervention.
- Integrate HWP document creation into a larger Python application or data pipeline on Windows.
- Script document-assembly workflows where HWP is the required output format in Korean-language environments.
- Extract or manipulate HWP document content programmatically via the HwpAutomation API.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Automates HWP (아래아한글) document creation and editing through Python by wrapping the HwpAutomation COM API via pywin32, enabling text insertion, document manipulation, and file operations on Windows.

Yes, if you are on Windows, have HWP installed, and need to automate HWP document operations from Python. The package has low install friction, active maintenance, and no known vulnerabilities. However, verify the license terms before use in commercial or copyleft-sensitive projects, and confirm that the HwpAutomation API coverage meets your specific automation needs.

## Install

pip install pyhwpx
uv add pyhwpx
poetry add pyhwpx

## Installing pyhwpx

Before you install: Low friction: pure Python wheel with six common dependencies (numpy, pandas, pywin32, openpyxl, pyperclip, Pillow). Maintenance status is active with a recent release (148 days ago). No compilation or system library builds required.

License in practice: License treatment is unclear—no SPDX identifier or raw license text is declared in the package metadata. Verify the actual license terms in the repository or documentation before adopting in commercial or copyleft-sensitive contexts.

Quickstart:

pip install pyhwpx

from pyhwpx import Hwp

hwp = Hwp()
hwp.insert_text("Hello world!")
hwp.save_as("./output.hwp")
hwp.quit()

Requires Windows OS, HWP (아래아한글) application installed, and Python >= 3.9. pywin32 must be available (installed as a dependency).

Verify before relying:

- Whether the package's license is compatible with your project's license requirements (no SPDX identifier provided).
- Scope and completeness of HwpAutomation API coverage beyond the basic insert_text and save_as examples shown.
- Whether all six runtime dependencies are always needed or if some are optional for specific use cases.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 420.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

hwp document automation python, korean word processor scripting, 아래아한글 자동화, hwp file generation, windows document automation, pywin32 hwp wrapper, korean office automation, windows-only, korean-office-automation, com-wrapper

[View on SkillFed](https://skillfed.io/packages/pyhwpx) · [View on PyPI](https://pypi.org/project/pyhwpx/)