https://github.com/epigos/react-ai-agent

React AI Agent with Long-Term Memory and Tool calling
https://github.com/epigos/react-ai-agent

agentic-ai chatbot langchain langgraph openai react-agent tools

Last synced: about 2 months ago
JSON representation

React AI Agent with Long-Term Memory and Tool calling

• Host: GitHub
• URL: https://github.com/epigos/react-ai-agent
• Owner: epigos
• License: mit
• Created: 2025-01-19T15:32:56.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-19T16:41:16.000Z (over 1 year ago)
• Last Synced: 2025-10-30T05:52:16.440Z (7 months ago)
• Topics: agentic-ai, chatbot, langchain, langgraph, openai, react-agent, tools
• Language: Python
• Homepage:
• Size: 424 KB
• Stars: 4
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# React Agent with Long-Term Memory and Tool Integration  

![CI](https://github.com/epigos/react-ai-agent/actions/workflows/ci.yaml/badge.svg)

This project demonstrates a **React Agent** built using **[LangGraph](https://langchain-ai.github.io/langgraph/tutorials/introduction/)** with advanced tool integration and long-term memory capabilities.

The agent is designed to assist users in customer support scenarios

with a rich set of tools and a sleek UI interface powered by **[Chainlit](https://docs.chainlit.io/get-started/overview)**.

## Features  

- **Knowledge Base Retriever**: Retrieves information from a FAISS-based knowledge base.  

- **Customer Information Tool**: Fetches user details for personalized support.  

- **Form Management**:  

  - Retrieve form details.  

  - Assist users in completing forms step-by-step.  

  - Submit forms and handle retries for any submission errors.  

- **Memory Capabilities**:  

  - **Save Memory**: Store contextual information during conversations.  

  - **Search Memory**: Retrieve past interactions to ensure continuity and context.  

  - Powered by **[Mem0AI](https://mem0.ai/)** for long-term memory management.  

- **Dynamic Chat UI**: A user-friendly interface created with **Chainlit** for seamless interaction with the chatbot.  

## Project Setup

1. Install dependencies with Poetry:  

   ```bash  

   poetry install  

   ```  

2. Setup environment variables:  Provide required api keys: OPENAI_API_KEY=your-api-key.

   ```bash  

   cp .env.example .env  

   ```  

3. Start the local server:  

   ```bash  

   make start  

   ```  

Access the API at http://localhost:8000

## Architecture  

The project utilizes **LangGraph** to define a conversational workflow, integrating tools and memory nodes. Below is an example diagram of the graph and the UI interface:  

### Graph Architecture  

![Graph Diagram](./assets/graph.png)  

### Chat UI  

![Chat UI](./assets/chat_ui.jpg)  

### Sample conversations

1. Check order history of a customer:

    ![Check order history](./assets/chatbot-1.jpg)  

2. Change user's address:

    ![Change address](./assets/chatbot-2.jpg)