To install the Agastya script on your website, you need your API key. You can find this in your admin panel or by getting in touch with us over support. Once you have your API key, make sure that you have added your website in the list of trusted domains, otherwise Agastya will show an unauthorized error in your console.

JavaScript loader

Replace the API_KEY in the line below with your API key and add it before closing the </body> tag.

<script src="" async></script>

This loader script will automatically load the most recent Agastya on your website, so your users always have the best features and security updates.

Deprecated loaders

The above and correct JavaScript loader was introduced in 2018 in version 3.0.0. To provide complete backwards compatibility, the loader script of version 2.0.0 and above were automatically redirected to 3.0.0.

However, if you are using any of the following older, deprecated JavaScript files, Agastya will not work on your website and you should migrate immediately to resume services.

Year URL Status
2017 Redirected
2017 Deprecated
2016 Deprecated

NPM package

If you're using a package manager like NPM or Yarn, you can use the following package, but additional configuration is required. Our NPM package has no dependencies and creates a script to load the plugin.


We recommend using Yarn because it caches your packages. You can use the following line to install the @oswaldlabs/agastya package to your project.

yarn add agastya


Alternately, if you're using the NPM client, you can use the following line instead.

npm install agastya


You need to do additional configuration and initialize the package. Add the following code to your entry file (app.js or index.js).

If you're using ES6 imports and a bundler like Webpack, you can use the following line to import the package to your project.

import agastya from "agastya"

Finally, initialize the plugin using the agastya.init function by supplying your API key as the parameter, and Agastya should be reading and working in your project.

new Agastya("API_KEY");