Installation and Connection

This topic contains information about installing the Oxygen AI Positron add-in in Oxygen XML Editor/Author/Developer/JSON Editor and connecting to an AI service.

Quick Installation

You can drag the following Install button and drop it into the main editor in Oxygen to quickly initiate the installation process:

Install

Manual Installation

To manually install this add-on, follow this procedure:
  1. Go to Help > Install new add-ons to open an add-on selection dialog box. Enter or paste https://www.oxygenxml.com/InstData/Addons/default/updateSite.xml in the Show add-ons from field or select it from the drop-down menu.
    Note:
    If you have issues connecting to the default update site, you can download the add-on package, unzip it, then use the Browse for local files action in the Install new add-ons dialog box to locate the downloaded addon.xml file.
  2. Select the Oxygen AI Positron add-on and click Next.
  3. Read the end-user license agreement. Then select the I accept all terms of the end-user license agreement option and click Install.
  4. Restart the application.

Result: The AI Positron side view is now available. If the view is not displayed, it can be opened by selecting it from Window > Show View.

Connecting to an AI Service

When you open the AI Positron side view for the first time after installation, you are greeted with two connection choices.

Figure 1. Connecting the AI Positron
Connect to AI Positron Service
This option uses the Oxygen AI Positron Service, which in turn uses functionality from AI services such as OpenAI, Claude, or Vertex AI. It is a subscription-based model and does not require any additional configuration.

Each user has a limit to the quantity of data that is sent to or received from the AI server each month and this is managed through the use of credits.

When you first log in, you get a free trial month for working with the add-on's various useful actions and experimenting with it on your content.

During or after your free trial month, you can subscribe to one of the plans in the Oxygen AI Positron website page.

Note:
You can cancel your subscription at anytime and any remaining credits can still be used up until the expiration date. Cancelled subscriptions cannot be renewed (a new subscription is required in this case).

Team Management for Oxygen AI Positron Service

In your Oxygen AI Positron Service web account, you can click the profile image and choose to create a new team. You can invite existing members to your team by creating a sharable link.

Once a team is created and members are invited to it, you can use the Team drop-down button to generate an overall usage report that shows the amount of consumed credits for each client.

The Invoices tab allows you to download invoices for each member of the team who has an active subscription.

Note:
When invoices are generated, if a subscription has been refunded, the system will show the refund invoice after the refund finishes processing.
Connect to other AI Services
Choosing this option takes you to the AI Service Configuration Preferences page where you can configure a connection to other AI services. OpenAI, Microsoft Azure OpenAI, Claude, AWS Bedrock, Google Gemini, and xAI Grok are provided as default configuration options, but you can also connect to Google's Vertex AI Service by installing the Oxygen AI Positron Vertex AI Connector Add-on, or you can configure a custom service by installing the Oxygen AI Positron Custom Connector Add-on.

This works free of charge with any Oxygen installation using an Enterprise license type.

If your license of Oxygen is NOT an Enterprise type of license, you will be directed to configure a license key. The special license key needs to be purchased from the Oxygen AI Positron website to enable this direct access.