Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings
/ Discute Public

Discute is an innovative, open-source language learning application designed to help users practice and perfect their speaking skills in a new language.

License

Notifications You must be signed in to change notification settings

5uru/Discute

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

11 Commits

Repository files navigation

πŸ‘‹ Welcome to Discute: Your AI Language Companion!

Discute is an innovative, open-source language learning application designed to help users practice and perfect their speaking skills in a new language. By leveraging the power of AI, Discute simulates realistic conversations, making language practice accessible and engaging.

πŸš€ Features

  • Real-time voice transcription using Whisper for accuracy in various languages.
  • Conversation simulation and language corrections powered by Groq LLM models.
  • Personalized feedback through voice cloning with the Kokoro model.
  • Intuitive and accessible user interface built with Streamlit.

πŸ› οΈ Technologies Used

  • Python
  • Groq for language models
  • Streamlit for frontend
  • SQLite for database management
  • Whisper for speech-to-text (STT)
  • Kokoro for text-to-speech (TTS)

πŸ“¦ Setup and Installation

To get "Discute" running locally:

  1. Clone the repository: git clone https://github.com/5uru/Discute.git
  2. Change directory: cd Discute
  3. Install required dependencies: pip install -r requirements.txt
  4. Obtain a Groq API key from https://console.groq.com/home
  5. Run the Streamlit application: streamlit run app.py

🧩 System Requirements

  • Python 3.8 or higher
  • Minimum 4GB RAM (8GB recommended)
  • Stable internet connection for AI models
  • Working microphone for voice input
  • Valid Groq API key

πŸ“š Usage Guide

  1. Initial Setup:

    • Launch the application with streamlit run app.py
    • Enter your Groq API key in the dedicated field
  2. Context Generation:

    • Describe a situation or use the random generator
    • Click "Generate Context" to create a conversation scenario
  3. Conversation:

    • Select a voice from the dropdown menu
    • Record your voice message using the audio input
    • Send your message with the "Send" button
    • Listen to the AI-generated response via Kokoro TTS
  4. Review:

    • Use "Review and Correct" to get feedback on your language skills
    • View corrections and improvement suggestions

About

Discute is an innovative, open-source language learning application designed to help users practice and perfect their speaking skills in a new language.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /