🧠 AI-English-Tutor

Lapulka – your voice-powered English tutor assistant! Practice speaking, get pronunciation feedback, and learn interactively with GPT.

---

🦄 Features 🎙️ Voice input via microphone with Whisper 💬 Text-to-speech replies using Nova 🧠 Feedback and guidance using GPT-3.5 / GPT-4o 📚 Vocabulary, grammar and pronunciation feedback modes

---

✅ Requirements Before you begin, make sure you have the following installed:

Python 3.11+ – https://www.python.org/downloads/

Git – https://git-scm.com/downloads

ffmpeg – #### How to install:

1. Go to 👉 https://www.gyan.dev/ffmpeg/builds/

2. Scroll to “Release builds” and download:
   ✅ ffmpeg-release-essentials.zip

3. Extract it to a folder, for example:
   F:\Programs\ffmpeg\

4. Open F:\Programs\ffmpeg\bin\ and make sure there is ffmpeg.exe

5. Add it to PATH:

   • Press Win + S, type environment variables, open it
   • Click Environment Variables
   • In System Variables, find Path → click Edit
   • Click New → paste:
     F:\Programs\ffmpeg\bin
   • Click OK → OK → OK

---

📥 Step-by-step Installation (For Beginners)

Follow these simple steps to run the AI-English-Tutor on Windows:

---

🗂️ Step 1: Create a Folder

1. Choose or create a folder where you'd like to install the program, for example:
   F:\MyProjects\AI-English-Tutor

2. Open that folder in Explorer

3. Click on the path bar at the top (where it shows F:\MyProjects\AI-English-Tutor)

4. Type cmd and press Enter
   👉 This will open a black command window in the right folder!

---

🌐 Step 2: Download the Project

In the command window, type:

git clone https://github.com/githubenj/AI-English-Tutor.git
cd AI-English-Tutor

💡 If you don’t have git, just download the ZIP from the GitHub page and unzip it into the folder.

---

🧪 Step 3: Create a Virtual Environment (Optional, but Recommended)

python -m venv venv
venv\Scripts\activate

---

📦 Step 4: Install Required Packages

Make sure pip is updated:

pip install --upgrade pip

Then install all the required packages:

pip install -r requirements.txt

---

▶️ Step 5: Run the Program

You can now start the tutor:

Just double-click on: 👉

run_AI.bat

(on Windows 💻)

---

Or alternatively:

1. Click on the path bar at the top (where it shows F:\MyProjects\AI-English-Tutor)

2. Type cmd and press Enter
   👉 This will open a black command window in the right folder!

3. Type

python main.py

and press Enter

---

✅ You're all set! Launch the app and start talking with Lapulka 💬🩷

---

🛟 Having issues?

Feel free to open an issue or ask in Discussions!

---

🦄 Features

• 🎙️ Voice input via microphone with Whisper
• 💬 Text-to-speech replies using Nova
• 🧠 Feedback and guidance using GPT-3.5 / GPT-4o
• 📚 Vocabulary, grammar and pronunciation feedback modes

💖 About

Made with love by Pusik & Lapulka.
Feel free to contribute, fork, and share the joy of learning.

“Speak from the heart, and Lapulka will guide you.” ✨

---

📜 License

MIT License © 2025