GITHUB_RELEASE_GUIDE.md INSTALL.md bot.py config.py README.md PROJECT_SUMMARY.md INSTALLATION.md index.html

config.py

"""
Configuration Module
Author: RSK World (https://rskworld.in)
Founder: Molla Samser
Designer & Tester: Rima Khatun
Contact: help@rskworld.in, +91 93305 39277
Year: 2026
Description: Configuration settings for multi-language chatbot
"""

import os
from dotenv import load_dotenv

# Load environment variables
load_dotenv()

class Config:
    """Base configuration"""
    
    # Basic Flask Configuration
    SECRET_KEY = os.getenv('SECRET_KEY', 'multi-language-chatbot-rsk-world-2026')
    DEBUG = os.getenv('FLASK_DEBUG', 'False').lower() == 'true'
    
    # Server Configuration
    HOST = os.getenv('HOST', '0.0.0.0')
    PORT = int(os.getenv('PORT', 5000))
    
    # API Keys
    OPENAI_API_KEY = os.getenv('OPENAI_API_KEY')
    GOOGLE_TRANSLATE_API_KEY = os.getenv('GOOGLE_TRANSLATE_API_KEY')
    
    # Chatbot Configuration
    MAX_CONVERSATION_LENGTH = int(os.getenv('MAX_CONVERSATION_LENGTH', 20))
    DEFAULT_LANGUAGE = os.getenv('DEFAULT_LANGUAGE', 'en')
    SUPPORTED_LANGUAGES = os.getenv('SUPPORTED_LANGUAGES', 'en,hi,bn,es,fr,de,zh,ja,ar,pt,ru,it').split(',')
    
    # Cultural Adaptation
    CULTURAL_ADAPTATION_ENABLED = os.getenv('CULTURAL_ADAPTATION_ENABLED', 'True').lower() == 'true'
    TIMEZONE_AWARENESS = os.getenv('TIMEZONE_AWARENESS', 'True').lower() == 'true'
    
    # Security
    CORS_ORIGINS = os.getenv('CORS_ORIGINS', '*').split(',')
    ENABLE_HTTPS = os.getenv('ENABLE_HTTPS', 'False').lower() == 'true'
    
    # Rate Limiting
    RATE_LIMIT_PER_MINUTE = int(os.getenv('RATE_LIMIT_PER_MINUTE', 60))
    
    # Logging
    LOG_LEVEL = os.getenv('LOG_LEVEL', 'INFO')
    LOG_FILE = os.getenv('LOG_FILE', 'logs/chatbot.log')
    
    # Database (Optional)
    DATABASE_URL = os.getenv('DATABASE_URL', 'sqlite:///chatbot.db')
    
    # Redis (Optional for caching)
    REDIS_URL = os.getenv('REDIS_URL', 'redis://localhost:6379/0')
    
    # Analytics
    ENABLE_ANALYTICS = os.getenv('ENABLE_ANALYTICS', 'False').lower() == 'true'
    ANALYTICS_API_KEY = os.getenv('ANALYTICS_API_KEY')
    
    # Language Detection Settings
    LANGUAGE_DETECTION_CONFIDENCE_THRESHOLD = float(os.getenv('LANGUAGE_DETECTION_CONFIDENCE_THRESHOLD', 0.7))
    
    # Translation Settings
    TRANSLATION_CACHE_SIZE = int(os.getenv('TRANSLATION_CACHE_SIZE', 1000))
    TRANSLATION_TIMEOUT = int(os.getenv('TRANSLATION_TIMEOUT', 10))
    
    # OpenAI Settings
    OPENAI_MODEL = os.getenv('OPENAI_MODEL', 'gpt-3.5-turbo')
    OPENAI_MAX_TOKENS = int(os.getenv('OPENAI_MAX_TOKENS', 500))
    OPENAI_TEMPERATURE = float(os.getenv('OPENAI_TEMPERATURE', 0.7))
    
    @staticmethod
    def init_app(app):
        """Initialize application with configuration"""
        pass

class DevelopmentConfig(Config):
    """Development configuration"""
    DEBUG = True
    LOG_LEVEL = 'DEBUG'

class ProductionConfig(Config):
    """Production configuration"""
    DEBUG = False
    ENABLE_HTTPS = True
    
    @classmethod
    def init_app(cls, app):
        Config.init_app(app)
        
        # Production-specific initialization
        import logging
        from logging.handlers import RotatingFileHandler
        
        if not app.debug:
            file_handler = RotatingFileHandler(
                cls.LOG_FILE, 
                maxBytes=10240000, 
                backupCount=10
            )
            file_handler.setFormatter(logging.Formatter(
                '%(asctime)s %(levelname)s: %(message)s [in %(pathname)s:%(lineno)d]'
            ))
            file_handler.setLevel(logging.INFO)
            app.logger.addHandler(file_handler)
            app.logger.setLevel(logging.INFO)
            app.logger.info('Multi-language Chatbot startup')

class TestingConfig(Config):
    """Testing configuration"""
    TESTING = True
    OPENAI_API_KEY = 'test-key'
    DEBUG = True

# Configuration dictionary
config = {
    'development': DevelopmentConfig,
    'production': ProductionConfig,
    'testing': TestingConfig,
    'default': DevelopmentConfig
}

def get_config():
    """Get current configuration based on environment"""
    env = os.getenv('FLASK_ENV', 'development')
    return config.get(env, config['default'])

129 lines•4.2 KB

python

README.md

Raw Download

README.md

# Multi-language Chatbot

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

![Multi-language Chatbot](https://img.shields.io/badge/Python-3.8+-blue.svg)
![License](https://img.shields.io/badge/License-MIT-green.svg)
![Status](https://img.shields.io/badge/Status-Active-brightgreen.svg)

**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.*

templates/index.html

Raw Download

<!DOCTYPE html>
<html lang="en">
<head>
    <!--
    Multi-language Chatbot Interface
    Author: RSK World (https://rskworld.in)
    Founder: Molla Samser
    Designer & Tester: Rima Khatun
    Contact: help@rskworld.in, +91 93305 39277
    Year: 2026
    Description: Modern web interface for multi-language chatbot
    -->
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Multi-language Chatbot - RSK World</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
    <link href="{{ url_for('static', filename='css/style.css') }}" rel="stylesheet">
    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
</head>
<body>
    <!-- Header -->
    <header class="bg-gradient-primary text-white py-3 shadow-sm">
        <div class="container">
            <div class="row align-items-center">
                <div class="col-md-6">
                    <h1 class="h3 mb-0">
                        <i class="fas fa-globe me-2"></i>
                        Multi-language Chatbot
                    </h1>
                    <p class="mb-0 opacity-75">Powered by RSK World</p>
                </div>
                <div class="col-md-6 text-md-end">
                    <span class="small">
                        <i class="fas fa-code me-1"></i>
                        Advanced NLP & Translation Technology
                    </span>
                </div>
            </div>
        </div>
    </header>

    <!-- Main Content -->
    <main class="container-fluid py-4">
        <div class="row">
            <!-- Sidebar -->
            <div class="col-lg-3 col-md-4 mb-4">
                <div class="card shadow-sm">
                    <div class="card-header bg-light">
                        <h5 class="card-title mb-0">
                            <i class="fas fa-cog me-2"></i>
                            Settings
                        </h5>
                    </div>
                    <div class="card-body">
                        <!-- Language Selection -->
                        <div class="mb-4">
                            <label for="languageSelect" class="form-label fw-semibold">
                                <i class="fas fa-language me-1"></i>
                                Preferred Language
                            </label>
                            <select class="form-select" id="languageSelect">
                                <option value="auto">Auto-detect</option>
                                {% for code, name in supported_languages.items() %}
                                <option value="{{ code }}">{{ name }}</option>
                                {% endfor %}
                            </select>
                        </div>

                        <!-- Features -->
                        <div class="mb-4">
                            <h6 class="fw-semibold mb-3">
                                <i class="fas fa-star me-1"></i>
                                Features
                            </h6>
                            <ul class="list-unstyled small">
                                <li class="mb-2">
                                    <i class="fas fa-check text-success me-2"></i>
                                    Multi-language support
                                </li>
                                <li class="mb-2">
                                    <i class="fas fa-check text-success me-2"></i>
                                    Auto translation
                                </li>
                                <li class="mb-2">
                                    <i class="fas fa-check text-success me-2"></i>
                                    Language detection
                                </li>
                                <li class="mb-2">
                                    <i class="fas fa-check text-success me-2"></i>
                                    Cultural adaptation
                                </li>
                                <li class="mb-2">
                                    <i class="fas fa-check text-success me-2"></i>
                                    Language switching
                                </li>
                            </ul>
                        </div>

                        <!-- Stats -->
                        <div class="mb-4">
                            <h6 class="fw-semibold mb-3">
                                <i class="fas fa-chart-bar me-1"></i>
                                Session Stats
                            </h6>
                            <div class="row g-2 text-center">
                                <div class="col-6">
                                    <div class="bg-light rounded p-2">
                                        <div class="fw-bold" id="messageCount">0</div>
                                        <div class="small text-muted">Messages</div>
                                    </div>
                                </div>
                                <div class="col-6">
                                    <div class="bg-light rounded p-2">
                                        <div class="fw-bold" id="languageCount">0</div>
                                        <div class="small text-muted">Languages</div>
                                    </div>
                                </div>
                            </div>
                        </div>

                        <!-- Actions -->
                        <div class="d-grid gap-2">
                            <button class="btn btn-outline-primary btn-sm" onclick="clearChat()">
                                <i class="fas fa-trash me-1"></i>
                                Clear Chat
                            </button>
                            <button class="btn btn-outline-secondary btn-sm" onclick="exportChat()">
                                <i class="fas fa-download me-1"></i>
                                Export Chat
                            </button>
                        </div>
                    </div>
                </div>

                <!-- Info Card -->
                <div class="card shadow-sm mt-3">
                    <div class="card-body">
                        <h6 class="fw-semibold mb-2">
                            <i class="fas fa-info-circle me-1"></i>
                            About
                        </h6>
                        <p class="small text-muted mb-2">
                            This advanced chatbot supports multiple languages with automatic detection and translation. Features include cultural adaptation for global applications.
                        </p>
                        <div class="small">
                            <strong>Technologies:</strong><br>
                            Python, OpenAI API, Translation APIs, NLP
                        </div>
                    </div>
                </div>
            </div>

            <!-- Chat Area -->
            <div class="col-lg-9 col-md-8">
                <div class="card shadow-sm h-100">
                    <div class="card-header bg-light d-flex justify-content-between align-items-center">
                        <h5 class="card-title mb-0">
                            <i class="fas fa-comments me-2"></i>
                            Chat Interface
                        </h5>
                        <div class="d-flex align-items-center">
                            <span class="badge bg-success me-2" id="statusBadge">
                                <i class="fas fa-circle me-1"></i>
                                Online
                            </span>
                            <span class="small text-muted" id="currentLanguage">
                                English
                            </span>
                        </div>
                    </div>
                    
                    <!-- Chat Messages -->
                    <div class="card-body p-0">
                        <div id="chatMessages" class="chat-messages">
                            <div class="text-center text-muted py-5">
                                <i class="fas fa-robot fa-3x mb-3 opacity-50"></i>
                                <p class="mb-0">Start a conversation in any language!</p>
                                <small>I'll detect your language and respond accordingly.</small>
                            </div>
                        </div>
                    </div>

                    <!-- Input Area -->
                    <div class="card-footer bg-light">
                        <div class="input-group">
                            <input 
                                type="text" 
                                class="form-control" 
                                id="messageInput" 
                                placeholder="Type your message in any language..."
                                onkeypress="handleKeyPress(event)"
                            >
                            <button class="btn btn-primary" onclick="sendMessage()">
                                <i class="fas fa-paper-plane me-1"></i>
                                Send
                            </button>
                        </div>
                        
                        <!-- Quick Actions -->
                        <div class="mt-3 d-flex flex-wrap gap-2">
                            <button class="btn btn-sm btn-outline-secondary" onclick="insertText('Hello, how are you?')">
                                <i class="fas fa-hand-wave me-1"></i>
                                Greeting
                            </button>
                            <button class="btn btn-sm btn-outline-secondary" onclick="insertText('What can you do?')">
                                <i class="fas fa-question me-1"></i>
                                Capabilities
                            </button>
                            <button class="btn btn-sm btn-outline-secondary" onclick="insertText('Thank you for your help')">
                                <i class="fas fa-heart me-1"></i>
                                Thanks
                            </button>
                            <button class="btn btn-sm btn-outline-secondary" onclick="detectLanguage()">
                                <i class="fas fa-language me-1"></i>
                                Detect Language
                            </button>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </main>

    <!-- Footer -->
    <footer class="bg-dark text-white py-4 mt-5">
        <div class="container">
            <div class="row">
                <div class="col-md-6">
                    <h6 class="mb-2">Multi-language Chatbot</h6>
                    <p class="small mb-0">
                        Advanced NLP chatbot with multi-language support and cultural adaptation.
                    </p>
                </div>
                <div class="col-md-6 text-md-end">
                    <p class="small mb-0">
                        © {{ current_year }} RSK World. All rights reserved.<br>
                        <i class="fas fa-envelope me-1"></i>
                        help@rskworld.in | 
                        <i class="fas fa-phone me-1"></i>
                        +91 93305 39277
                    </p>
                </div>
            </div>
        </div>
    </footer>

    <!-- Loading Modal -->
    <div class="modal fade" id="loadingModal" tabindex="-1" data-bs-backdrop="static" data-bs-keyboard="false">
        <div class="modal-dialog modal-sm modal-dialog-centered">
            <div class="modal-content">
                <div class="modal-body text-center py-4">
                    <div class="spinner-border text-primary mb-3" role="status">
                        <span class="visually-hidden">Processing...</span>
                    </div>
                    <p class="mb-0">Processing your message...</p>
                </div>
            </div>
        </div>
    </div>

    <!-- Scripts -->
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
    <script src="{{ url_for('static', filename='js/chatbot.js') }}"></script>
</body>
</html>

267 lines•12.6 KB

markup

Theme Settings

Color Scheme

Display Options

Font Size

README.md

Theme Settings

Color Scheme

Display Options

Font Size

README.md

🚀 Support RSK World