https://github.com/mc095/kawaii-chatbot
Distress Support Chatbot Using llama3-8b
https://github.com/mc095/kawaii-chatbot
chainlit chainofthought langchain-python llama3
Last synced: 4 months ago
JSON representation
Distress Support Chatbot Using llama3-8b
- Host: GitHub
- URL: https://github.com/mc095/kawaii-chatbot
- Owner: mc095
- Created: 2024-07-09T17:20:30.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-26T10:32:09.000Z (5 months ago)
- Last Synced: 2025-06-06T11:24:35.928Z (4 months ago)
- Topics: chainlit, chainofthought, langchain-python, llama3
- Language: JavaScript
- Homepage: https://ashhealth07.netlify.app/
- Size: 7.49 MB
- Stars: 1
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ashley - Your Kawaii Mental Health Companion 🌸
## Overview 💫
Ashley is my passion project - a kawaii-styled mental health chatbot designed to be your digital companion. Built with Chainlit and powered by Groq's advanced language model, Ashley provides empathetic responses and creates a safe space for comforting conversations.
## Features 🌟
- 💕 Kawaii-themed interface for a friendly, approachable experience
- 🎭 Advanced sentiment analysis to understand your emotions
- 💬 Real-time chat with empathetic responses
- 🎨 Customizable layout with styled components
- 🤝 Engaging conversations that feel personal and meaningful
## Technologies Used 🛠️
### Frontend
- React (for building our beautiful UI)
- Bootstrap (for responsive design)
- React Icons (for kawaii visual elements)
- React Router DOM (for seamless navigation)
- Typewriter Effect (for engaging animations)
- React Parallax Tilt (for interactive elements)
- Web Vitals (for performance monitoring)
### Backend
- Chainlit (for creating our chat interface)
- Groq API (powering Ashley's intelligent responses)
- TextBlob & NLTK (for sentiment analysis)
- LangChain (for conversation management)
- Python dotenv (for secure configuration)
## Getting Started
### Prerequisites
- Python (v3.7 or higher)
- Node.js (v14 or higher)
- Groq API Key
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/your-username/kawaii-chatbot.git
cd kawaii-chatbot
```
2. **Install frontend dependencies:**
```bash
cd client
npm install
```
3. **Install backend dependencies:**
```bash
cd ../chatbot/ashBot
pip install -r requirements.txt
```
4. **Set up your environment:**
Create a `.env` file in the ashBot directory:
```env
GROQ_API_KEY=your_groq_api_key
```
## Running Ashley
### Frontend
```bash
cd client
npm start
```
### Backend
```bash
cd chatbot/ashBot
chainlit run app.py
```
## Project Structure 📁
```
kawaii-chatbot/
├── client/ # React frontend
├── chatbot/
│ └── ashBot/ # Chainlit backend
├── images/ # UI assets
└── README.md
```
## Development Scripts 🛠️
### Frontend
- `npm start`: Launch development server
- `npm run build`: Create production build
- `npm test`: Run tests
- `npm run eject`: Eject CRA configuration
### Backend
- `chainlit run app.py`: Start the Chainlit application
## Contributing
Feel free to contribute to making Ashley even better! Whether it's adding new features, improving responses, or enhancing the kawaii aesthetics, all contributions are welcome!