Please enable JavaScript to view this site.

Altova RaptorXML Server 2021

Starting with RaptorXML Server 2017, the Python API is available as a native Python wheel package for Python 3.7. The Python wheel package can be installed as an extension module into your favored Python 3.7 distribution (for example, from Some Python 3 distributions (for example, from, and include a wide range of extension modules for big data, mathematics, science, engineering and graphics. These modules now become available to RaptorXML Server without the need to build these modules specifically for RaptorXML Server. Otherwise, the wheel package works the same way as the RaptorXMLXBRL-python.exe application that is included with RaptorXML Server.


Note:The Python wheel package is a native Python 3.7 extension module and is compatible with Python version 3.7.


Note:The Python wheel package does not include the Python API v1.


Note:If you update your version of RaptorXML Server, make sure to update the Python wheel package in your Python environment.


The information required to correctly install the RaptorXML Server package is given in the sections below:


Name of wheel file

Location of wheel file

Installing a wheel with pip

The root catalog file

The JSON config file


For information about how to use RaptorXML Server's Python API, see the Python API Reference and examples. Also see example scripts that use Raptor's Python API at


Name of wheel file

Wheel files are named according to the following pattern:


raptorxmlserver-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl





Location of wheel file

A wheel file is packaged with your installation of RaptorXML Server. It is located in the application's bin folder:



Program Files\Altova\RaptorXMLServer2021\bin






Installing a wheel with pip

To install the RaptorXML Server package as a Python module, use the pip command:


pip install <wheel-file>.whl

python -m pip install <wheel-file>.whl  


If you have installed Python 3.7 or later from, then pip will already be installed. Otherwise, you will need to install pip first. For more information, see


The root catalog file

The RaptorXML module for Python must be able to locate RootCatalog.xml, the root catalog file that is stored in your RaptorXML Server installation folder. This is so that the RaptorXML module can use the catalog to correctly locate the various resources, such as schemas and other specifications, that the module references in order to carry out functions such as validations and transformations. The RaptorXML module will automatically locate RootCatalog.xml if the catalog's location has not been changed subsequent to the installation of RaptorXML Server.


In case you move or modify your RaptorXML Server environment, or if you move RootCatalog.xml from its original installed location, then you can specify the catalog's location by means of environment variables and the RaptorXML module's JSON Config File. See the list below for the various ways in which you can do this. The RaptorXML module determines the location of RootCatalog.xml by looking up the following resources in the order given.





Create with a value that is the path to RootCatalog.xml


HKLM Registry: SOFTWARE\Altova\RaptorXMLServer\Installation_v2021_x64\Setup\CatalogPath

Registry key is added by RaptorXML Server installer. Value is the path to RootCatalog.xml. Windows only


Location: /opt/Altova/RaptorXMLServer2021/etc/RootCatalog.xml

Linux only


Location: /usr/local/Altova/RaptorXMLServer2021/etc/RootCatalog.xml

Mac only



Create with a value that is the path to the JSON config file.


Location: .altova/raptorxml-python.config

The JSON config file in the current working directory


Location: ~/.config/altova/raptorxml-python.config

The JSON config file in the user's home directory


Location: /etc/altova/altova/raptorxml-python.config

The JSON config file. Linux and Mac only


The JSON config file

You can create a JSON config file for the RaptorXMLServer module. This file will be used by options 5 to 8 in the table above to locate the root catalog file. The JSON config file must contain a map with a "CatalogPath" key that has a value which is the path to the root catalog file.


Listing of JSON config file



  "CatalogPath": "/path/to/RootCatalog.xml"



© 2015-2021 Altova GmbH