npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@gptstonks/chatbot

v0.1.3

Published

GPTStonks Open-source Chatbot

Downloads

65

Readme

📦 GPTStonks Chatbot 🚀

Contributors Forks Stargazers Issues


What is GPTStonks Chatbot?

GPTStonks Chatbot is a versatile and customizable chatbot solution designed to enhance user interactions with AI in web applications and other platforms. Built with React and TypeScript, the chatbot offers a range of features, including WebSocket support for real-time messaging and streaming, full styling customization, and API REST integration. Developers can easily integrate the chatbot into their applications, tailoring its appearance and functionality to meet specific requirements. The chatbot is designed to be extensible, allowing for custom renderers and data handling functions to be implemented as needed.

Status

Work in Progress

The GPTStonks Chatbot is currently under active development. We are working tirelessly to enhance its capabilities, aiming to include a wide range of features that will cater to various use cases and applications. Our goal is to make GPTStonks Chatbot the go-to solution for developers looking for a highly customizable, efficient, and easy-to-integrate chatbot.

Upcoming Features

  • Improved AI Integration: Plans are in place to integrate more advanced AI and natural language processing (NLP) capabilities, allowing for more sophisticated and nuanced conversations with users.
  • Enhanced Customization Options: We are expanding the customization options available to developers, making it easier to tailor the chatbot's appearance and functionality to fit the specific needs of any application.
  • Increased Accessibility Features: Accessibility is a priority, and upcoming releases will focus on making GPTStonks Chatbot more accessible to users with disabilities, ensuring a broader range of individuals can interact with the chatbot seamlessly.
  • Seamless Integration with External Services: We are working on integrations with popular external services and platforms, enabling developers to leverage the full potential of the chatbot in their applications.
  • More Comprehensive Documentation: As new features are added, our documentation will grow to include detailed guides, tutorials, and examples to help developers make the most of the GPTStonks Chatbot.

Real Examples

We are currently using this package in a production environment in GPTStonks, our AI financial assistant. The chatbot is an integral part of the user experience, allowing users to interact with the AI and receive personalized insights and recommendations.


ChatbotWebsocket Package

The ChatbotWebsocket package provides a powerful and customizable chatbot UI component for React applications, featuring WebSocket support for real-time messaging and full styling capabilities to match your app's look and feel.

Features

  • WebSocket Support: Seamlessly integrate real-time messaging into your application using WebSocket.
  • Full Styling Customization: Customize every part of the chat interface with detailed theme configuration.
  • API Integration: Easy setup for both WebSocket and traditional HTTP API endpoints.
  • Extensible Rendering: Customize how messages and data are rendered within the chat interface.

Installation

npm install @gptstonks-chatbot

Ensure you have React and @mui/material installed as they are peer dependencies.

Package Exports

  • useChatbotDefaultTheme: A hook providing default theme configuration. This can be overridden with custom settings.
  • ChatbotWebsocket: The main chatbot component.

Usage

Below is an example of how to integrate the ChatbotHttp component into a real project:

import useChatbotDefaultTheme from '@/components/chat/ChatbotDefaultTheme';
import ChatbotWebsocket from '@/layouts/ChatbotWebsocket';
import React from 'react';

export default function Home() {
  const [initializedChat, setInitializedChat] = React.useState(false);
  const [chatData, setChatData] = React.useState<any>(null);

  const themeConfig = useChatbotDefaultTheme;

  return (
    <main
      style={{
        display: 'flex',
        justifyContent: 'center',
        alignItems: 'center',
        height: '100vh',
        backgroundColor: '#080808',
      }}
    >
      <div style={{ width: '20vw', height: '100%' }}></div>
      <div style={{ width: '60vw', height: '100%' }}>
        <ChatbotWebsocket
          apiConfig={{
            auth: false,
            tokenName: 'userToken',
            fetchFunction: '',
            queryEndpoint: 'ws://localhost:5000/chatws',
            queryParams: {
              type: 'type',
              data: 'result_data',
              text: 'body',
              reference: 'reference',
              related: 'related',
            },
          }}
          themeConfig={themeConfig}
          setDataForParent={(data: any) => {
            setChatData(data);
          }}
          onApiResponseCode={(bool: boolean) => {
            setInitializedChat(bool);
          }}
          userMessageRenderFunction={(text: string) => (
            <YourCustomComponent>{text}</YourCustomComponent>
          )}
          botMessageRenderFunction={(text: string) => (
            <YourCustomComponent>{text}</YourCustomComponent>
          )}
          dataRenderFunction={(data: any) => <YourCustomComponent>{data}</YourCustomComponent>}
          graphicalDataRenderFunction={(data: any) => (
            <YourCustomComponent>{data}</YourCustomComponent>
          )}
          errorRenderFunction={(error: string) => <YourCustomComponent>{error}</YourCustomComponent>}
        />
      </div>
      <div style={{ width: '20vw', height: '100%' }}></div>
    </main>
  );
}

In this example, the ChatbotWebsocket component is configured with WebSocket support and a custom API endpoint. The theme is customized with specific colors, typography, and component styles. Custom renderers are provided for text messages, data tables, graphical data, and error messages. An onApiResponseCode callback function is included to handle API response codes.

Using default theme configuration: If you want to use the default theme configuration provided by the package, you can use the useChatbotDefaultTheme hook and override specific settings as needed:

import React from 'react';
import { ChatbotWebsocket, useChatbotDefaultTheme } from '@gptstonks/chatbot';

function App() {
  const themeConfig = useChatbotDefaultTheme();
  themeConfig.palette.primary.main = '#ff0000'; // Override primary color and other settings as needed

  return (
    <ChatbotWebsocket
      apiConfig={{
        queryEndpoint: "ws://localhost:8000/chatws",
      }}
      themeConfig={themeConfig}
    />
  );
}

Configuration

APIConfig

Customize the chatbot's API endpoints and authentication settings:

  • isWebsocket: Determines whether to use WebSocket for real-time communication.
  • queryEndpoint: The endpoint URL for the API or WebSocket connection.
  • auth (optional): Enables authentication.
  • tokenName (optional): The key name for the authentication token in localStorage.
  • fetchFunction (optional): A custom fetch function for API calls.
  • queryParams (optional): Maps response object keys to internal keys for processing.

ThemeConfig

Adjust the chatbot's appearance:

  • style: General CSSProperties for the chatbot's container.
  • palette: Defines the color scheme, including primary, secondary, and other states like error, warning, info, and success.
  • typography: Configures font settings.
  • components: Allows styling of individual components such as the chat box, text field, button, etc.

Handling Data and Errors

  • botMessageRenderFunction: Custom renderer for text messages.
  • dataRenderFunction: Custom renderer for displaying data tables or lists.
  • graphicalDataRenderFunction: Custom renderer for displaying graphical data, such as charts or graphs.
  • errorRenderFunction: Custom renderer for displaying error messages.
  • onApiResponseCode: A callback function for handling API response codes, allowing you to react to specific server responses, such as authentication failures or rate limits.

Customization

The package utilizes @mui/material for UI components and supports extensive customization through the themeConfig prop. You can tailor the chat UI to seamlessly integrate with your application's design, ensuring a consistent user experience.

Real-Time and API Communication

ChatbotWebsocket intelligently handles both WebSocket and traditional HTTP API communications, ensuring that your chatbot can interact with users in real-time or through standard request-response cycles, depending on your configuration.

🛠️ Stack

  • [![Typescript][typescript-badge]][typescript-url] - JavaScript with syntax for types.
  • [![Tailwind CSS][tailwind-badge]][tailwind-url] - A utility-first CSS framework for rapidly building custom designs.

External dependencies

  • @mui/material: Material-UI components for building the chatbot UI (https://mui.com/).
  • react: Core library for building React applications.
  • useWebSocket: A custom hook for managing WebSocket connections in React applications (https://www.npmjs.com/package/use-websocket). Will try to implement a workaround for this dependency in the future so that it is not required.