Metadata-Version: 2.1
Name: aspose-words
Version: 25.11.0
Summary: Aspose.Words for Python is a Document Processing library that allows developers to work with documents in many popular formats without needing Office Automation.
Home-page: https://products.aspose.com/words/python-net/
Author: Aspose
Project-URL: Docs, https://docs.aspose.com/words/python-net/
Project-URL: Release Notes, https://releases.aspose.com/words/python/release-notes/2025/aspose-words-for-python-via-dotnet-25-11-release-notes/
Project-URL: Demos, https://products.aspose.app/words/family
Project-URL: API Reference, https://reference.aspose.com/words/python-net/
Project-URL: Examples, https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/
Project-URL: Blog, https://blog.aspose.com/category/words/
Project-URL: Free Support, https://forum.aspose.com/c/words
Project-URL: Temporary License, https://purchase.aspose.com/temporary-license
Keywords: doc,docx to pdf,convert,compare,create,edit,word,split,bmp,rtf,odt,open office,html,tiff,dot,wordml,mobi,chm,txt,md,markdown,xps,svg,ps,postscript,pcl,epub,png,emf,jpg,gif,mail merge,table,reporting,document
Platform: win_amd64
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: Other/Proprietary License
Classifier: License :: Free To Use But Restricted
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Office/Business
Classifier: Topic :: Office/Business :: Office Suites
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Markup
Requires-Python: >=3.6,<3.14
Description-Content-Type: text/markdown

[Product Page](https://products.aspose.com/words/python-net/) | [Docs](https://docs.aspose.com/words/python-net/) | [Demos](https://products.aspose.app/words/family) | [API Reference](https://reference.aspose.com/words/python-net/) | [Examples](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/) | [Blog](https://blog.aspose.com/category/words/) | [Search](https://search.aspose.com/) | [Free Support](https://forum.aspose.com/c/words) | [Temporary License](https://purchase.aspose.com/temporary-license)

Try our [free online Apps](https://products.aspose.app/words/family) demonstrating some of the most popular Aspose.Words functionality.

[Aspose.Words for Python](https://products.aspose.com/words/python-net/) is a powerful on-premise class library that can be used to perform a wide range of document-processing tasks, including document generation, editing, conversion, and rendering. The library is fully self-contained and does not require any third-party software like Microsoft Word or OpenOffice. With the addition of our new AI-powered features—such as document summarization, translation, and grammar checking—you can now bring intelligent automation into your document workflows using your preferred AI model.

## Word API Features

The following are some popular features of Aspose.Words for Python:

- Aspose.Words can be used to develop applications for a vast range of operating systems such as Windows, Linux, or macOS.
- Comprehensive [document import and export](https://docs.aspose.com/words/python-net/loading-saving-and-converting/) with [35+ supported file formats](https://docs.aspose.com/words/python-net/supported-document-formats/). This allows users to [convert documents](https://docs.aspose.com/words/python-net/convert-a-document/) from one popular format to another, for example, from DOCX into PDF or Markdown, or from PDF into various Word formats.
- Provides [AI-powered features](https://docs.aspose.com/words/python-net/ai-powered-features/) to summarize documents, translate content and check grammar, enhancing document intelligence and productivity.
- Programmatic access to the formatting properties of all document elements. For example, using Aspose.Words users can [split a document](https://docs.aspose.com/words/python-net/split-a-document/) into parts or [compare two documents](https://docs.aspose.com/words/python-net/compare-documents/).
- [High-fidelity rendering](https://docs.aspose.com/words/python-net/rendering/) of document pages. For example, if it is necessary to render a document as in Microsoft Word, Aspose.Words will successfully cope with this task.
- [Generate reports with Mail Merge](https://docs.aspose.com/words/python-net/mail-merge-and-reporting/), which allows filling in merge templates with data from various sources to create merged documents.
- LINQ Reporting Engine to fetch data from databases, XML, JSON, OData, external documents, and much more.

## Supported Document Formats
Aspose.Words for Python supports [a wide range of formats for loading and saving documents](https://docs.aspose.com/words/python-net/supported-document-formats/), some of them are listed below:
**Microsoft Word:** DOC, DOT, DOCX, DOTX, DOTM, FlatOpc, FlatOpcMacroEnabled, FlatOpcTemplate, FlatOpcTemplateMacroEnabled, RTF, WordML, DocPreWord60
**OpenDocument:** ODT, OTT
**Web:** HTML, MHTML
**Markdown:** MD
**Markup:** XamlFixed, HtmlFixed, XamlFlow, XamlFlowPack
**Fixed Layout:** PDF, XPS, OpenXps
**Image:** SVG, TIFF, PNG, BMP, JPEG, GIF
**Metafile:** EMF
**Printer:** PCL, PS
**Text:** TXT
**eBook:** MOBI, CHM, EPUB

## Platform Independence

Aspose.Words for Python can be used to develop applications for a vast range of operating systems, such as Windows, Linux, and macOS, where Python 3.5 or later is installed. You can build both 32-bit and 64-bit Python applications.

## Get Started

Ready to give Aspose.Words for Python a try?

Simply run ```pip install aspose-words``` from the Console to fetch the package.
If you already have Aspose.Words for Python and want to upgrade the version, please run ```pip install --upgrade aspose-words``` to get the latest version.

You can run the following snippets in your environment to see how Aspose.Words works, or check out the [GitHub Repository](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET) or [Aspose.Words for Python Documentation](https://docs.aspose.com/words/python-net/) for other common use cases.

## Using Python to Create a DOCX File from Scratch

Aspose.Words for Python allows you to create a new blank document and add content to this document.

```python
import aspose.words as aw

# Create a blank document.
doc = aw.Document()

# Use a document builder to add content to the document.
builder = aw.DocumentBuilder(doc)
# Write a new paragraph in the document with the text "Hello World!".
builder.writeln("Hello, World!")

# Save the document in DOCX format. Save format is automatically determined from the file extension.
doc.save("Output.docx")
```

## Using Python to Convert a Word Document to HTML

Aspose.Words for Python also allows you to convert Microsoft Word formats to PDF, XPS, Markdown, HTML, JPEG, TIFF, and other file formats. The following snippet demonstrates the conversion from DOCX to HTML:

```python
import aspose.words as aw

# Load the document from the disc.
doc = aw.Document("Document.docx")

# Save the document to HTML format.
doc.save("Output.html")
```

## Using Python to Import PDF and Save as a DOCX File

In addition, you can import a PDF document into your Python application and export it as a DOCX format file without the need to install Microsoft Word:

```python
import aspose.words as aw

# Load the PDF document from the disc.
doc = aw.Document("Document.pdf")

# Save the document to DOCX format.
doc.save("Output.docx")
```

### Translate a Word document using your preferred AI model, such as OpenAI or Google models.

```python
import aspose.words as aw

doc = aw.Document("Document.docx")

# Use Google generative language models.
model = aw.ai.AiModel.create(aw.ai.AiModelType.GEMINI_15_FLASH).with_api_key("API_KEY").as_google_ai_model()

translated_doc = model.translate(doc, aw.ai.Language.ARABIC)
translated_doc.save("Output.docx")
```

[Product Page](https://products.aspose.com/words/python-net/) | [Docs](https://docs.aspose.com/words/python-net/) | [Demos](https://products.aspose.app/words/family) | [API Reference](https://reference.aspose.com/words/python-net/) | [Examples](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/) | [Blog](https://blog.aspose.com/category/words/) | [Search](https://search.aspose.com/) | [Free Support](https://forum.aspose.com/c/words) | [Temporary License](https://purchase.aspose.com/temporary-license)
