---

---

🤖 NeuroChat Memory AI

🧠 Multi-Chat AI Assistant with Memory using LangChain & Gemini 2.5 Flash

---

🚀 Live Demo

🔗 Try the App Here:
👉 https://neurochat-memory-ai-tyntnh3j9rwxytr9ufqcju.streamlit.app/

---

🚀 Overview

NeuroChat Memory AI is an advanced conversational AI application that supports:

• 💬 Multiple chat sessions
• 🧠 Context-aware memory (remembers previous conversations)
• ⚡ Fast and structured AI responses
• 🌐 Gemini 2.5 Flash powered intelligence

It mimics ChatGPT-like behavior with chat history navigation + contextual understanding.

---

✨ Features

• 💬 Multi-Chat System
• 🧠 Conversation Memory Handling
• 📚 Persistent Chat History (JSON Storage)
• 🔄 Switch Between Chats
• 🏷️ Auto Chat Titles (based on first question)
• ⚡ Fast Responses using Gemini 2.5 Flash
• 🎯 Structured & Accurate AI Output
• ⏳ Loading Spinner for Better UX
• 🌐 Streamlit Cloud Deployment
• 🔐 Secure API Key Handling

---

🧠 Tech Stack

Technology	Purpose
Streamlit	Frontend UI
LangChain	LLM Orchestration
Gemini 2.5 Flash	AI Model
Python	Backend Logic
JSON	Chat Storage
dotenv	Environment Management

---

🧩 LangChain Components Used

• 🧠 LLM → ChatGoogleGenerativeAI (Gemini)
• 🔗 Chains → LLMChain-style invocation
• 🧰 Tools → Custom tools (if extended)
• 🤖 Agents → Custom agent executor (manual structured agent)
• 💬 Messages → Human / AI message formatting
• 🧠 Memory → Custom conversation memory (history injection)

---

📁 Project Structure

neurochat-memory-ai/
│
├── app/
│   ├── main.py
│   ├── chat_ui.py
│   ├── sidebar.py
│
├── agents/
│   ├── agent_builder.py
│   ├── tools.py
│
├── core/
│   ├── config.py
│   ├── memory.py
│
├── storage/
│   ├── chat_store.py
│   ├── chats.json
│
├── utils/
│   ├── helpers.py
│
├── assets/
│   ├── home.png
│   ├── chat.png
│   ├── history.png
│   ├── memory.png
│
├── .streamlit/
│   ├── secrets.toml
│
├── .env
├── .gitignore
├── requirements.txt
├── README.md
├── LICENSE

---

📸 Application Screenshots

🏠 Home Screen

💬 Chat Interaction

📚 Chat History

🧠 Memory (Context Awareness)

---

⚙️ Installation

1️⃣ Clone Repository

git clone https://github.com/22AD040/neurochat-memory-ai.git
cd neurochat-memory-ai

2️⃣ Create Virtual Environment

python -m venv venv
venv\Scripts\activate

3️⃣ Install Requirements

pip install -r requirements.txt

4️⃣ Add Environment Variables

Create .env file:

GEMINI_API_KEY=your_api_key_here

---

▶️ Run Locally

streamlit run app/main.py

---

🌐 Deployment (Streamlit Cloud)

• Push code to GitHub
• Go to Streamlit Cloud
• Add Secrets:

GEMINI_API_KEY = your_api_key

• Deploy 🚀

---

🔒 Security

• 🔐 API keys stored in .env / Streamlit Secrets
• 🚫 .gitignore prevents sensitive files upload
• 🧠 Chat sessions isolated per user
• 📁 chats.json excluded from Git

---

📌 Future Enhancements

• 🧠 Vector DB Memory (FAISS / Chroma)
• 📄 File Upload + RAG
• 🌍 Multi-language support
• 🔐 Authentication system
• 📊 Analytics dashboard

---

👩‍💻 Author

Ratchita B
🎓 Artificial Intelligence & Data Science

---

⭐ Support

If you like this project:

• 👉 Give it a ⭐ on GitHub
• 👉 Share with others

---

📜 License

This project is licensed under the MIT License

---