@thirdrocktechno/directus-extension-directusgpt
v0.0.2
Published
A DirectusGPT plugin for integrating AI-powered custom ChatBot with your Directus content.
Downloads
7
Readme
DirectusGPT plugin for Directus
OpenAI is an AI research lab known for their work on natural language processing, computer vision, and robotics. This plugin uses an OpenAI API for Text Embedding, and Text generation.
Directus is a headless CMS that simplifies API development. This plugin uses Directus to sync data into pinecone db, customize ChatBot UI and much more.
Pinecone is a fast and efficient vector database for AI applications. This plugin uses Pinecone to find similarities and generate text on the basis of that.
Ably is a messaging platform for real-time data delivery. This plugin uses Ably to publish & subscribe the tokens from Directus to ChatBot.
LangChain is a framework for developing applications powered by language models. It allows developers to connect a language model to other sources of data and allow a language model to interact with other systems. This plugin uses LangChain for a conversation like search in the ChatBot.
Overview: Integrate a custom ChatBot in your frontend using DirectusGPT.
With this plugin, you can integrate a custom ChatBot in your frontend by just copy & pasting a script in your frontend. The ChatBot will answer according to your content of Directus in your frontend.
Setting up the plugin is super easy and can be completed within few minutes.
- Go to the Tab COLLECTION TYPES & Enable the collection types on which you want to integrate search from the plugin UI.
- Go to the Tab SETTINGS & Enter the credentials for OpenAI, Ably, and Pinecone ( with pinecone index name & environment ).
- Go to the Tab WIDGET & Configure the ChatBot content from Sub-tab CONTENT & UI from Sub-tab APPEARANCE according to your needs.
- Go to the Sub-tab SCRIPT of WIDGET tab & Enter your frontend URL & backend URL ( Backend URL must be your Directus URL ).
- Click on the Update button to save the settings.
- Click on the Refresh Data button to sync the data from Directus to pinecone vector db for the enabled collection types.
- Copy & Paste the script in your frontend to add the ChatBot.
Thats it! You can now use ChatBot in your frontend to ask your queries.
✨ Features
- Easy to use: The plugin is easy to use and can be set up within 10 minutes.
- Customizable: You can customize the ChatBot UI according to your needs.
- Open Source: The plugin is open source and can be found on GitHub
🖐 Requirements
The plugin is designed for Directus v9.25.
⏳ Installation
1. Install the plugin
The package is published to npm:
npm install @thirdrocktechno/directus-extension-directusgpt
Manual Installation
- Download or fork the repository
- Go to the repository directory and install the dependencies
npm install
- Build the extension. Build will be created in dist folder.
npm run build
- While being in the repository, Copy the package.json and dist folder to your extension folder. Create directus-extension-directusgpt folder in extensions folder if it doesn't exists.
cp -r dist/ package.json ../extensions/directus-extension-directusgpt
- Now you can navigate to your Directus project directory and restart your Directus instance.
The DirectusGPT plugin should appear in the Plugins section of the Directus sidebar after you run the app again.
Now you are ready to configure DirectusGPT on your Directus website 🎉
🔧 Configuration
You can easily configure the DirectusGPT plugin in the Directus admin panel.
- Goto
DirectusGPT
->SETTINGS
Tab in the plugin UI. - Enter All the required field values in the SETTINGS tab.
- Click on Update to save the configuration.
📖 Testing the plugin
- Click DirectusGPT plugin in plugin section of the sidebar.
- Enable the collection type on which you want to provide the AI search within the ChatBot.
- Click on the WIDGET tab and configure ChatBot content from the sub-tab CONTENT & UI from the sub-tab APPEARANCE according to your needs.
- Click on Update button to save the changes and then Click on Refresh Data to sync data from Directus to the vectordb ( this will create an embeddings of your content and save it for finding the similarities. )
- Click on the Sub-tab SCRIPT of the same Widget tab and update frontend & backend URL the save config again by clicking on the Update button again.
- Copy the show script and paste it in your frontend to show the ChatBot for integrating an AI ChatBot.
📝 License
Copyright © 2023 Third Rock Techkno LLP
Let us know!
If you use our open-source libraries in your project, please make sure to credit us and Give a star.