Skip to content

A Hmong language learning web application powered by a fine-tuned OpenAI Whisper model for real-time speech-to-text transcription. Built with React (Vite) and Python (FastAPI)

Notifications You must be signed in to change notification settings

hmongcodequest/hmong-language

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Language Learning App

This is a language learning app that uses AI to help you learn new languages.

Project Structure

  • frontend/: React + Vite + TypeScript frontend application
  • whisper/: Python + FastAPI backend linked to a fine-tuned Whisper model

Getting Started

Prerequisites

  • Node.js 18+
  • Python 3.10+
  • Bun

Installation

The application is split into two parts: Backend and Frontend. You need to set up both.

1. Backend (API)

Navigate to the whisper directory and set up the Python environment:

cd whisper
python -m venv venv

Activate the virtual environment:

  • Windows:
    venv\Scripts\activate
  • Mac/Linux:
    source venv/bin/activate

Install Python dependencies:

pip install -r requirements.txt

2. Frontend (Client)

Navigate to the frontend directory and install dependencies:

cd frontend
bun install

Usage

You need to run both the backend and frontend terminals simultaneously.

Terminal 1: Start the Backend

cd whisper
venv\Scripts\activate
python api.py

The API server will start at http://localhost:8000.

Terminal 2: Start the Frontend

cd frontend
bun dev

The web application will start (usually at http://localhost:5173). Open the link shown in your terminal to use the app.

About

A Hmong language learning web application powered by a fine-tuned OpenAI Whisper model for real-time speech-to-text transcription. Built with React (Vite) and Python (FastAPI)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published