Skip to content

muhammedkucukaslan/learnbystory

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 

Repository files navigation

AI-Powered Language Learning Story Generator

A web application that generates personalized stories and quizzes for language learners using OpenAI. The application creates content based on students' interests to make language learning more engaging and effective.

We built it for a hackathon project on 28 December 2024. So, it was built in less than 24 hours :)

Features

  • Personalized story generation based on student interests
  • Automatic quiz generation for reading comprehension
  • Interactive user interface for easy navigation
  • AI-powered content creation using OpenAI
  • Authentication system

Tech Stack

  • Backend: Express.js
  • Frontend: Next.js
  • AI Integration: OpenAI API

Prerequisites

  • OpenAI API key

Installation

  1. Clone the repository:
git clone https://github.com/muhammedkucukaslan/learnbystory
  1. Install backend dependencies:
cd backend
npm install
  1. Install frontend dependencies:
cd frontend
npm install
  1. Add your OpenAI key and PORT to .env:
OPENAI_API_KEY=your_api_key_here
PORT=8000

Running the Application

  1. Start the backend server:
cd backend
npm run dev
  1. Start the frontend development server:
cd frontend
npm run dev

The web application will be available at http://localhost:3000. The backend server will be running at http://localhost:8000 by default.

Usage

  1. Students log in to the platform
  2. Select their interests and language level
  3. The system generates personalized stories
  4. Students read the story and answer generated questions

Demo

demo

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages