G-Translate (💱 👉🏻 🔡) | AI SaaS Language Translation Tool

Table of Contents

• Introduction
• Tech Stack
• Features
• Getting Started
  • Prerequisites
  • Cloning the Repository
  • Installation
  • Set Up Environment Variables
  • Running the Project
• Usage
• Contributing
• License
• Contact

Introduction

G-Translate is a cutting-edge AI SaaS language translation tool developed using Next.js and TypeScript. It enables users to translate spoken words into different languages, making it an invaluable resource for those learning new languages or needing real-time translation. By leveraging the latest in speech recognition and AI translation technology, G-Translate offers an intuitive and powerful solution for language barriers.

Tech Stack

• Next.js
• TypeScript
• OpenAI API
• React Speech Recognition
• Tailwind CSS

Features

• Speech Recognition: Converts spoken words into text using the Web Speech API.
• Text Translation: Translates recognized text into a selected target language using OpenAI's GPT-4 model.
• Audio Playback: Converts translated text back into speech using the Web Speech API's speech synthesis.
• File Upload: Reads and translates text from uploaded files, including RTF to plain text conversion.
• Link Content Fetching: Fetches and translates text content from provided URLs.
• Language Selection: Allows users to select target languages for translation.
• Copy to Clipboard: Copies translated text to the clipboard.
• User Interaction: Provides features for users to like, dislike, and favorite translations.
• Responsive Design: Ensures a seamless experience across different devices.

Getting Started

Follow these steps to set up the project locally on your machine.

Prerequisites

Ensure you have the following installed on your machine:

• Git
• Node.js
• npm (Node Package Manager)

Cloning the Repository

Clone the repository using the following command:

git clone https://github.com/themihirmathur/G-Translate.git
cd G-Translate

Installation

Install the project dependencies using npm:

npm install

Set Up Environment Variables

Create a new file named .env in the root of your project and add the following content:

API_KEY=<your-openai-api-key>

Replace the placeholder values with your actual OpenAI credentials. You can obtain these credentials by signing up on the OpenAI website.

Running the Project

Start the development server:

npm run dev

Open http://localhost:3000 in your browser to view the project.

Usage

1. Speech Recognition: Click the microphone icon to start speaking and convert speech to text.
2. Translation: Select the target language and click the translate button to translate the text.
3. Audio Playback: Click the play button to hear the translated text.
4. File Upload: Upload a file to read and translate its text content.
5. Link Content Fetching: Enter a URL to fetch and translate text content from the webpage.
6. User Interaction: Like, dislike, or favorite translations for future reference.

Contributing

We welcome contributions to enhance the functionality of G-Translate. Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes and commit them (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature-branch).
5. Create a new Pull Request.

Contact

For any inquiries or feedback, please contact Mihir Mathur at themihirmathur@gmail.com.

---

This README provides a comprehensive overview of the G-Translate project, guiding you through setup, usage, and contribution. Feel free to reach out if you have any questions or need further assistance.