Active Story is a story generation app that allows parents and their children to interactively create stories. It demonstrates how AI can make bedtime stories more interactive and fun. It gives parents and kids a chance to bond as they co-create stories, making the experience both playful and hands-on. The app features a FastAPI backend for story generation, a React frontend for the user interface, and MongoDB for data persistence.
The FastAPI backend provides the endpoints for generating stories. It's responsible for handling the story input and returning a story that can be dynamically updated based on user interactions.
To run the FastAPI backend locally, use the following command:
uvicorn active_story_service.main:app --reload --host 0.0.0.0 --port 8000This will start the backend server on http://localhost:8000/.
The app uses MongoDB for storing story data, and it runs inside a Docker container.
To start MongoDB using Docker, navigate to the mongo-docker directory and run:
docker-compose upThis will spin up a MongoDB instance locally. Ensure that you have Docker installed and running on your system.
The React-based frontend provides the user interface where parents can input themes and interact with the story generation process.
- Landing Page: Allows users to input a theme for the story.
- Story Page: Displays the story, including interactive improvisation input.
Navigate to the ui folder and start the frontend by running:
npm startThis will start the frontend on http://localhost:3000/.
- Backend: Python 3.x, FastAPI, Uvicorn
- Frontend: Node.js, React
- Database: MongoDB (via Docker)
-
Clone the Repository:
git clone https://github.com/gosandhya/active-story.git cd active-story -
Backend Setup:
- Navigate to the
backendfolder:cd backend - Install dependencies:
pip install -r requirements.txt
- Run the FastAPI server:
uvicorn active_story_service.main:app --reload --host 0.0.0.0 --port 8000
- Navigate to the
-
Frontend Setup:
- Navigate to the
uifolder:cd ui - Install dependencies:
npm install
- Start the React frontend:
npm start
- Navigate to the
-
MongoDB Setup:
- Navigate to the
mongo-dockerfolder:cd mongo-docker - Start MongoDB using Docker:
docker-compose up
- Navigate to the
access swagger docs: http://localhost:8000/docs