README.md

# Multi-language Chatbot

**Advanced NLP Chatbot with Multi-language Support and Cultural Adaptation**


**Developed by RSK World (https://rskworld.in)**
*Founder: Molla Samser | Designer & Tester: Rima Khatun*
*Contact: help@rskworld.in | +91 93305 39277*
*Year: 2026*

---

## 🌟 Features

### Core Features
- **🌍 Multi-language Support**: Communicate in 12+ languages including English, Hindi, Bengali, Spanish, French, German, Chinese, Japanese, Arabic, Portuguese, Russian, and Italian
- **🔍 Automatic Language Detection**: Automatically detects user's language with confidence scoring
- **🔄 Real-time Translation**: Seamlessly translates messages between supported languages
- **🎭 Cultural Adaptation**: Adapts responses based on cultural context and regional preferences
- **💬 Intelligent Conversation**: Powered by OpenAI GPT with fallback to rule-based responses
- **🎨 Modern Web Interface**: Responsive, Bootstrap-based UI with real-time chat
- **📊 Session Analytics**: Track conversation statistics and language usage
- **💾 Chat History**: Save and export conversation history
- **🔒 Security Features**: Rate limiting, input validation, CORS configuration
- **🧪 Comprehensive Testing**: Full test suite with pytest

### Advanced Features
- **🎤 Voice Input/Output**: Speech-to-text and text-to-speech capabilities with multiple language support
- **😊 Sentiment Analysis**: Advanced sentiment and emotion detection with multi-language support
- **🧠 Conversation Memory**: Persistent conversation context with learning capabilities
- **📄 Document Analysis**: Support for PDF, Word, Excel, images with OCR and content extraction
- **👥 Real-time Collaboration**: Multi-user chat rooms with WebSocket support
- **📈 Advanced Analytics**: Comprehensive analytics dashboard with visualizations and reports
- **🎭 Personality Customization**: Multiple personality profiles (Professional, Friendly, Casual, Academic, Creative)
- **🖼️ Multi-modal Input**: Support for text, voice, images, video, and mixed input processing
- **🤖 AI-Powered Features**: OpenAI integration for advanced NLP capabilities
- **📱 Mobile Responsive**: Fully responsive design for all devices

---

## 🚀 Quick Start

### Prerequisites

- Python 3.8 or higher
- pip (Python package manager)
- OpenAI API key (optional, for AI responses)
- Google Translate API key (optional, for enhanced translations)

### Installation

1. **Clone or download the project**
```bash
cd multi-language-chatbot
```

2. **Create a virtual environment**
```bash
python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate
```

3. **Install dependencies**
```bash
pip install -r requirements.txt
```

4. **Set up environment variables**
```bash
# Copy the example environment file
cp .env.example .env

# Edit .env file with your API keys
# OPENAI_API_KEY=your_openai_api_key_here
# GOOGLE_TRANSLATE_API_KEY=your_google_translate_api_key_here
```

5. **Run the application**
```bash
python run.py
```

6. **Open your browser**
Navigate to `http://localhost:5000`

---

## 📁 Project Structure

```
multi-language-chatbot/
├── app.py # Main Flask application
├── run.py # Application runner
├── config.py # Configuration settings
├── requirements.txt # Python dependencies
├── .env.example # Environment variables template
├── README.md # This file
├── modules/ # Core modules
│ ├── __init__.py
│ ├── language_detector.py # Language detection
│ ├── translator.py # Translation services
│ ├── cultural_adapter.py # Cultural adaptation
│ └── chatbot_core.py # Chatbot logic
├── templates/ # HTML templates
│ └── index.html # Main interface
├── static/ # Static assets
│ ├── css/
│ │ └── style.css # Stylesheets
│ └── js/
│ └── chatbot.js # JavaScript functionality
├── tests/ # Test files
├── logs/ # Log files
└── instance/ # Instance files
```

---

## 🛠️ Configuration

### Environment Variables

Create a `.env` file based on `.env.example`:

```bash
# Required for AI responses
OPENAI_API_KEY=your_openai_api_key_here

# Optional for enhanced translations
GOOGLE_TRANSLATE_API_KEY=your_google_translate_api_key_here

# Flask settings
FLASK_ENV=development
SECRET_KEY=your-secret-key-here

# Server settings
HOST=0.0.0.0
PORT=5000
```

### Supported Languages

The chatbot supports the following languages:

| Code | Language | Native Name |
|------|----------|-------------|
| en | English | English |
| hi | Hindi | हिन्दी |
| bn | Bengali | বাংলা |
| es | Spanish | Español |
| fr | French | Français |
| de | German | Deutsch |
| zh | Chinese | 中文 |
| ja | Japanese | 日本語 |
| ar | Arabic | العربية |
| pt | Portuguese | Português |
| ru | Russian | Русский |
| it | Italian | Italiano |

---

## 🎯 Usage

### Basic Usage

1. **Open the web interface** at `http://localhost:5000`
2. **Type your message** in any supported language
3. **The chatbot will**:
- Detect your language automatically
- Process your message
- Respond in the same language
- Adapt responses culturally

### Advanced Features

- **Language Selection**: Manually select your preferred language
- **Language Detection**: Detect the language of any text
- **Chat Export**: Export conversation history as JSON
- **Session Stats**: View message count and languages used
- **Cultural Adaptation**: Responses are adapted for cultural context

### API Endpoints

- `POST /chat` - Send a message and get response
- `POST /detect_language` - Detect language of text
- `POST /translate` - Translate text between languages
- `GET /languages` - Get supported languages
- `GET /health` - Health check

---

## 🔧 Development

### Running Tests

```bash
# Install test dependencies
pip install pytest pytest-flask

# Run tests
pytest tests/
```

### Code Style

```bash
# Format code
black .

# Check linting
flake8 .
```

### Adding New Languages

1. Update `SUPPORTED_LANGUAGES` in `config.py`
2. Add language patterns in `language_detector.py`
3. Update language mappings in `translator.py`
4. Add cultural context in `cultural_adapter.py`

---

## 🌐 API Reference

### Chat Endpoint

**POST** `/chat`

```json
{
"message": "Hello, how are you?",
"language": "en"
}
```

**Response:**
```json
{
"response": "I'm doing well, thank you! How can I help you today?",
"detected_language": "en",
"language_name": "English",
"confidence": 0.95
}
```

### Language Detection Endpoint

**POST** `/detect_language`

```json
{
"text": "Bonjour, comment allez-vous?"
}
```

**Response:**
```json
{
"language": "fr",
"language_name": "Français (French)",
"confidence": 0.92
}
```

### Translation Endpoint

**POST** `/translate`

```json
{
"text": "Hello, world!",
"source_language": "en",
"target_language": "es"
}
```

**Response:**
```json
{
"translated_text": "¡Hola, mundo!",
"source_language": "en",
"target_language": "es"
}
```

---

## 🔒 Security

- Input validation and sanitization
- Rate limiting to prevent abuse
- CORS configuration
- Environment variable protection
- Secure session handling

---

## 📊 Monitoring

### Logging

- Application logs stored in `logs/chatbot.log`
- Configurable log levels
- Error tracking and reporting

### Analytics

- Message count tracking
- Language usage statistics
- Performance monitoring
- User session analytics

---

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

---

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

## 📞 Support

**RSK World**
- 📧 Email: help@rskworld.in
- 📱 Phone: +91 93305 39277
- 🌐 Website: https://rskworld.in
- 📍 Address: Nutanhat, Mongolkote, Purba Burdwan, West Bengal, India, 713147

---

## 🙏 Acknowledgments

- OpenAI for GPT API
- Google for Translate API
- Flask web framework
- Bootstrap for UI components
- Font Awesome for icons

---

## 📈 Version History

- **v1.0.0** (2026) - Initial release with multi-language support
- Features: Language detection, translation, cultural adaptation, web interface

---

**© 2026 RSK World. All rights reserved.**
*Content used for educational purposes only.*