Welcome to the Kids Story Generator! This project, developed for the Hack-a-Week 2025 event, aims to create fun, engaging, and personalized bedtime stories for children based on simple prompts provided by users.
The Kids Story Generator allows users to input prompts (e.g., a character, object, or theme) to generate customized, delightful stories for children. It leverages modern web technologies to ensure an interactive and enjoyable experience for both kids and parents.
- Personalized Stories: Create unique stories based on your child's favorite themes or characters.
- Engaging Plotlines: Fun and educational content designed to stimulate creativity.
- Kid-Friendly Interface: Simple and intuitive navigation for young users.
- Responsive Design: Fully optimized for mobile and desktop devices.
Follow these steps to set up the project locally:
- Node.js (v14 or higher)
- npm (v6 or higher)
- Python - Django (if working with the backend)
git clone [email protected]:SijanJ/Kids_story_generator.git
cd kids-story-generatorcd frontend
npm installcd backend
pip install -r requirements.txt
# Download required data
cd backend/story_backend
python download.pynpm startVisit http://localhost:3000 in your browser.
python manage.py runserver 8080When ready to deploy, build the app for production:
npm run buildThe optimized app will be available in the build folder.
Within the project directory, you can execute the following scripts:
Runs the app in development mode. The app will be available at http://localhost:3000. Any changes you make will reload automatically, and lint errors will appear in the console.
Launches the test runner in interactive watch mode. Refer to the Create React App Testing Documentation for details.
Builds the app for production. It optimizes the app for better performance and creates a minified version in the build folder.
Note: Ejecting is a one-way operation. It provides full control over the build configuration but cannot be undone. Use it only if necessary.
Explore more about React and Create React App using the following resources:
Additional Topics:
We welcome contributions to the Kids Story Generator! If you have ideas for improvement, feel free to open an issue or submit a pull request.
This project is licensed under the MIT License. See the LICENSE file for details.
This project requires an OpenAI API key for certain features. Alternatively, you can use gTTS (Google Text-to-Speech) for free. Bing image authentication cookies are needed to generate images.
Short demo video showcasing the application is available: