Python installation#

You can get started with Connext right away by installing the Python API.

Note that for add-on libraries, the code generator, infrastructure services, tools and utilities, you will need a full installation.

1. Install the Python API#

Install the python API as follows:

pip install rti.connext

2. Get a free evaluation license#

Get a free evaluation license file at https://www.rti.com/free-trial.

After filling out a brief form, you will receive an email with the license file, rti_license.dat.

(You don’t need to download any additional installer at this point to continue using the Python API.)

Existing customers

If you have already purchased a Connext bundle, please follow the installation instructions here instead.

3. Run a Hello World#

We will run a simple Connext application to verify the installation in a directory of your choice.

Copy the rti_license.dat file to this directory, or set the environment variable RTI_LICENSE_FILE to the path of the license file.

Create a file named hello_publisher.py with the following content:

hello_publisher.py#
from time import sleep
import rti.connextdds as dds
from rti.types.builtin import String


participant = dds.DomainParticipant(0)
topic = dds.Topic(participant, "Hello", String)
writer = dds.DataWriter(topic)

for i in range(100):
    writer.write(String(f"Hello World #{i}"))
    sleep(1)

Create a file named hello_subscriber.py with the following content:

hello_subscriber.py#
import rti.connextdds as dds
import rti.asyncio
from rti.types.builtin import String

async def main():
    participant = dds.DomainParticipant(0)
    topic = dds.Topic(participant, "Hello", String)
    reader = dds.DataReader(topic)

    async for data in reader.take_data_async():
        print(data)

rti.asyncio.run(main())

In one terminal, run the subscriber:

$ python hello_subscriber.py

In another terminal, run the publisher:

$ python hello_publisher.py

You should see the following output in the subscriber terminal:

String(value='Hello World #0')
String(value='Hello World #1')
...

Congratulations! You have successfully installed the Connext Python API.

Next steps#

Now you’re ready to build your own Connext distributed applications. You can complete many of the tutorials with just the Python API, but some require the full Connext installation.

Learn Connext