ProChat

Components Library for Quickly Building LLM Chat Interfaces. [![][npm-release-shield]][npm-release-link] [![][npm-downloads-shield]][npm-downloads-link] [![][github-releasedate-shield]][github-releasedate-link] [![][github-action-test-shield]][github-action-test-link] [![][github-action-release-shield]][github-action-release-link] [![][codecov-shield]][codecov-link]
[![][github-contributors-shield]][github-contributors-link] [![][github-forks-shield]][github-forks-link] [![][github-stars-shield]][github-stars-link] [![][github-issues-shield]][github-issues-link] [![][github-license-shield]][github-license-link]
[![][ant-design-shield]][ant-design-link] [![][devops-dumi-shield]][devops-dumi-link] [![][devops-father-shield]][devops-father-link] English · [简体中文](./README.zh-CN.md) · [Changelog](./CHANGELOG.md) . [Report Bug][github-issues-link] · [Request Feature][github-issues-link] 

📦 Installation

[!IMPORTANT]

This package is ESM only.

To install @ant-design/pro-chat, run the following command:

$ pnpm install @ant-design/pro-chat

This project is based on antd antd-style, so if you have not installed these two dependencies, please install them.

$ pnpm install antd-style // peerDependencies
$ pnpm install antd // peerDependencies

Compile with Next.js

[!NOTE]

By work correct with Next.js SSR, add transpilePackages: ['@ant-design/pro-chat'] to next.config.js. For example:

const nextConfig = {
  transpilePackages: [
    '@ant-design/pro-chat',
    '@ant-design/pro-editor',
    'react-intersection-observer',
  ],
};

[!NOTE]

If you are using a new version of NextJs (higher than 14), you no longer need to configure transpilePackages to run in NextJs.

🔨 Usage

import { ProChat } from '@ant-design/pro-chat';

export default () => (
  <ProChat
    request={async (messages) => {
      // Send a request with Message as the parameter
      return Message; // Supports both streaming and non-streaming
    }}
  />
);

✨ Features

[!NOTE]

ProChat focuses on quickly setting up a large language model chat dialogue framework. It aims to empower developers to easily create rich, dynamic, and intuitive chat interfaces.

Framework and Solutions for Chat Interface Components:

• 🔄 Automatic Chat Caching: Maintains conversation continuity without any extra effort, ensuring a smooth user experience.
• 💬 Streamlined Conversations: Offers the choice between different conversation styles, catering to diverse user preferences.
• ✏️ Message Editing Features: Provides a suite of editing tools, including request redo, edit combination, and deletion, for precise conversation control.
• 📖 Auto-rendered Markdown: Delivers a rich text experience that immerses users by transforming Markdown into beautifully formatted messages.
• 🎚️ Programmatic Controls (Ref): Commands the chat flow with precision, allowing developers to create a tailored conversational experience.

Design Evolution / In Progress

• [ ] Customized Dialogue Rendering with Edit Capabilities - issue/21
• [ ] Enhanced Request Parameters - The power to infuse additional parameters into your requests is on the horizon
• [ ] Personalized Error Handling - Craft unique fallbacks and configurations for those unexpected moments
• [ ] Expanded Documentation & Globalization - Access comprehensive guides and international support for a truly borderless experience
• [ ] Atomic Component Design - Anticipate a modular approach to design that promises both simplicity and versatility

👀 Showcase

Let's showcase some of ProChat's signature features:

Streamlined Dialogue	Content Editor
Engage in Streamlined Conversations that flow as naturally as a river	Refine, reshape, and perfect your dialogue with tools that allow for real-time edits.
Integrated Render
Dive into the vivid world of chat with our Built-in Render, a tool designed to bring text to life.

🖥 Browser compatibility

[!NOTE]

• Modern browsers and Internet Explorer 11 (with polyfills)
• Electron

Edge	last 2 versions	last 2 versions	last 2 versions	last 2 versions

⌨️ Local Development

You can use Github Codespaces for online development:

Or clone it for local development:

$ git clone https://github.com/ant-design/pro-chat.git
$ cd pro-chat
$ pnpm install
$ pnpm dev

🤝 Contributing

[!IMPORTANT]

Join our collaborative ecosystem. Your contributions are the heartbeat of our project. Here's how you can be an integral part of our vibrant community:

• Integrate and Innovate: Incorporate Ant Design Pro, umi, and ProChat into your projects. Your real-world usage and feedback are invaluable to us.
• Voice Your Insights: Encounter a glitch? Have a query? Your perspectives matter. Share them by submitting issues and help us enhance the user experience.
• Shape the Future: Have code enhancements or feature ideas? We invite you to propose pull requests and contribute directly to the evolution of our codebase.

Every contribution, big or small, is celebrated. Join us in our mission to refine and elevate the world of open-source enterprise UI components. 😃

🛣️ Ecosystem

• ProComponents - Designed for Enterprise-Level Application, Use Ant Design like a Pro!.
• ProEditor - The Ultimate Editor UI Framework and Components.
• ProFlow - A Flow Editor Framework base on React-Flow.
• ProChat - Components Library for Quickly Building LLM Chat Interfaces.

📝 License

Copyright © 2023 - present AFX & Ant Digital.
This project is MIT licensed.