# Extensions Installation

**Cognigy Support**  
June 2, 2023

To install an Extension, we provide two different ways:

- Install from download  
- Install from source code

## Download

The easiest way of integrating an already published Extension to your existing Cognigy.AI agent is to download the released ready-to-use tar.gz package :

1. Download the module you'd like to install from our [Library](https://support.cognigy.com/hc/en-us/articles/360016409380)
2. Upload the zipped folder into your Cognigy.AI installation

## Source Code

The other way is to build the module on your own. All modules in this repository are provided as [TypeScript](https://www.typescriptlang.org/) source code which can be transpiled to JavaScript. To use them in your Cognigy.AI installation, you need to perform the following steps:

1. Clone the repository
2. Navigate to a module folder (e.g. extensions/hubspot), run `npm install` to install dependencies, and `tsc` to transpile the module from TypeScript to JavaScript.
3. If the build process didn't zip the files already, zip the root of the module and the /build folder
   - `tar extension-name.tar.gz build/* icon.png README.md package.json package-lock.json`
4. Upload the zipped folder into your Cognigy.AI installation.

# Upload an Extension

1. Login to Cognigy.AI
2. Go to **Manage > Extensions.**
3. Click on **Upload Extension** and select your zipped folder.
4. Cognigy uploads your Extension and notifies you as soon as it is uploaded to the agent.
5. Go to the Flow editor.
6. Click the **+** button and select the uploaded extension from the **Extensions** tab.

The extension will appear in your Flow.

### Getting Started

- [Extensions Overview](https://support.cognigy.com/hc/en-us/articles/360016409380-Extensions-Overview)
- [NPM Package: @cognigy/extension-tools](https://support.cognigy.com/hc/en-us/articles/4413844565906-NPM-Package-cognigy-extension-tools)
- [Getting Started with Extensions](https://support.cognigy.com/hc/en-us/articles/360016534459-Getting-Started-with-Extensions)
- [Extensions Installation](https://support.cognigy.com/hc/en-us/articles/360016505680-Extensions-Installation)
- [Extensions Best Practices](https://support.cognigy.com/hc/en-us/articles/360016505740-Extensions-Best-Practices)
- [Adding Child Nodes](https://support.cognigy.com/hc/en-us/articles/360018106500-Adding-Child-Nodes)