The CineWave Demo is a complete cinema booking ecosystem showcasing a modern frontend, AI-powered agent, and modular backend services. It demonstrates how a movie platform can combine real-time booking, intelligent assistance, and seamless user experience.

This monorepo contains four main components:

A modern Next.js web app for browsing movies, managing bookings, and chatting with the CineAgent. Key features:

• Movie discovery and trailer previews
• Showtime search and filtering
• Interactive seat booking
• Chat-based CineAgent assistance

A FastAPI backend providing the foundation of the CineWave ecosystem. Responsibilities:

• Movie, hall, and showtime management
• Booking logic with seat validation
• MongoDB integration for persistence

A FastAPI microservice powering the CineAgent AI assistant. Responsibilities:

• Chat-style interaction endpoints
• Business logic for bookings and showtimes
• Integration with the Core API

A command-line interface to interact with the CineWave platform. Responsibilities:

• Terminal-based CineAgent chat
• Access to movies, showtimes, and bookings
• Connects to Core API for real-time data

Click Fork on GitHub to create your own copy of this repository.

git clone https://github.com/dileepadev/cinewave-demo.git
cd cinewave-demo

cd cinewave-core-api
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
fastapi dev main.py --port 8000

cd ../cinewave-agent-api
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
fastapi dev main.py --port 9000

cd ../cinewave-portal
npm install
npm run dev

Portal runs at http://localhost:3000.

cd ../cinewave-agent-cli
python app.py

If you like this project and want to see future updates, please consider giving it a star on GitHub!

• Frontend → Next.js, React, TypeScript, Tailwind CSS
• Backend APIs → FastAPI, Pydantic, MongoDB
• AI Agent → Chat-based assistant via Agent API & CLI
• Infrastructure → Modular microservices design

cinewave-demo/
├── cinewave-portal/       # Web frontend (Next.js)
├── cinewave-core-api/     # Backend core service (FastAPI, MongoDB)
├── cinewave-agent-api/    # AI Agent service (FastAPI)
├── cinewave-agent-cli/    # Command-line CineAgent client
├── diagrams.png           # System architecture diagram
└── README.md              # Root documentation

This project is licensed under the MIT License.

If you have any questions or suggestions regarding this project, feel free to open an issue or submit a pull request in this repository.

You can also reach me via email at: [email protected]