A real-time communication platform enabling seamless conversations between people speaking different languages through instant message translation.

LanCon eliminates language barriers by providing instant translation capabilities for text and soon voice communications. It offers natural, fluid conversations between speakers of different languages without requiring any party to know the other's language.

• Real-time message translation between multiple languages
• User authentication and profile management
• Secure WebSocket-based chat system
• Text-to-speech conversion
• Theme customization options
• User search functionality
• Multi-language interface support

• English
• Japanese
• Spanish
• French
• German
• Chinese (Simplified)
• Korean
• Hindi
• Russian
• Arabic

• React 19
• React Router v7
• TailwindCSS
• WebSocket API
• Web Audio API

• FastAPI
• MongoDB
• WebSocket
• Whisper (OpenAI) for speech recognition
• Gemini AI for translation
• gTTS (Google Text-to-Speech)

• Python 3.12+
• Node.js 19+
• MongoDB Atlas account
• Google Cloud API key
• Gemini AI API key

1. Configure backend environment:

MONGO_URL=your_mongodb_connection_string
GEMINI_API_KEY=your_gemini_ai_api_key

2. Install backend dependencies:

cd backend
pip install fastapi uvicorn motor pymongo python-jose[cryptography] passlib python-multipart whisper google-cloud-translate gtts google-generativeai python-dotenv

3. Install frontend dependencies:

cd frontend
npm install

1. Start backend server:

cd backend
uvicorn main:app --reload

2. Start frontend development server:

cd frontend
npm start

Access points:

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs

1. Register or use demo accounts:

   • Username: username1 / Password: username1
   • Username: username2 / Password: username2

2. Select your preferred language from the language dropdown

3. Start chatting - messages will automatically:

   • Detect the source language
   • Translate to recipient's preferred language
   • Support voice input/output in selected languages

• POST /users/register - User registration
• POST /users/token - Authentication
• GET /users/me - Profile retrieval

• WebSocket /ws/{user_id} - Chat connection
• GET /search - User search
• POST /upload-audio - Audio processing

lancon/
├── backend/
│   ├── app/
│   │   ├── auth/       # Authentication logic
│   │   ├── chat/       # WebSocket handling
│   │   ├── config/     # App configuration
│   │   ├── database/   # Database connection
│   │   ├── models/     # Data models
│   │   ├── routers/    # API routes
│   │   └── translation/# Translation services
│   └── main.py         # FastAPI application
└── frontend/
    ├── src/
    │   ├── components/ # React components
    │   ├── models/     # Frontend models
    │   ├── utils/      # Utility functions
    │   └── App.js      # Main React component
    └── package.json

• Additional regional languages and dialects
• Support for less common languages
• Improved dialect recognition
• Enhanced cultural context awareness

• Video chat with live translations
• Mobile applications
• Enhanced AI translation accuracy
• Gaming-specific translation modules
• Real-time language learning suggestions

• Offline functionality
• Advanced accent adaptation
• Neural voice modulation
• End-to-end encryption
• Regional server deployment
• Improved context awareness for translations

1. Fork the repository
2. Create a feature branch (git checkout -b feature/enhancement)
3. Commit changes (git commit -m 'Add enhancement')
4. Push to branch (git push origin feature/enhancement)
5. Open a Pull Request

Proprietary software. All rights reserved. See LICENSE for terms.