Ritual-AI is a comprehensive web application that allows users to explore, understand, and connect with cultural traditions from across the globe. Built with Next.js and powered by AI, it provides an immersive experience for discovering rituals, ceremonies, and cultural practices from different civilizations.
- Browse through a comprehensive database of cultural rituals and ceremonies
- Filter by culture, region, occasion, and ritual type
- Detailed information about each ritual's significance, participants, and elements
- Beautiful card-based interface with smooth animations
- Interactive AI-powered chat for in-depth ritual information
- Ask questions about specific rituals, cultural practices, or traditions
- Get contextual insights and explanations from our knowledge base
- Powered by LangChain and OpenAI for intelligent responses
- Create new ritual concepts based on your preferences
- AI-assisted generation for creative exploration
- Combine elements from different cultures and traditions
- Perfect for educational purposes or creative inspiration
- Explore rituals by geographic regions
- Discover cultural connections and influences
- Interactive regional browsing experience
- Advanced search functionality across all rituals
- Search by name, culture, occasion, or keywords
- Fast and responsive search results
- Framework: Next.js with App Router
- Language: TypeScript
- Styling: Tailwind CSS
- UI Components: Radix UI primitives with custom components
- Animation: Framer Motion
- AI Integration: LangChain with OpenAI
- Icons: Lucide React
- Theme: Next Themes for dark/light mode support
The application includes a rich dataset of cultural rituals with detailed information:
- Ritual Details: Name, culture/region, occasion, date, type
- Rich Descriptions: Significance, participants, cultural context
- Visual Elements: Images and symbolic representations
- Categorization: Tags, categories, and related rituals
- Detailed Elements: Specific components and practices within each ritual
- Node.js 18.0 or later
- npm or yarn package manager
-
Clone the repository
git clone https://github.com/ehsanpo/Ritual-AI.git cd Ritual-AI -
Install dependencies
npm install # or yarn install -
Set up environment variables
cp .env.example .env.local
Add your OpenAI API key and other required environment variables:
OPENAI_API_KEY=your_openai_api_key_here
-
Run the development server
npm run dev # or yarn dev -
Open your browser
Navigate to http://localhost:3000 to see the application.
/- Homepage with hero section and feature overview/explore- Main ritual explorer with filtering and search/chat- AI chat interface for ritual discussions/generator- AI-powered ritual generator/regions- Regional exploration of rituals/search- Advanced search functionality/about- About the project and its mission/ritual/[id]- Individual ritual detail pages
The application uses a comprehensive design system built on:
- Radix UI: Accessible, unstyled components
- Custom UI Components: Cards, buttons, forms, navigation
- Responsive Design: Mobile-first approach
- Dark Mode: System preference detection with manual toggle
- Animations: Smooth transitions and micro-interactions
npm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint├── app/ # Next.js 13 app directory
│ ├── api/ # API routes
│ ├── globals.css # Global styles
│ └── (pages)/ # Application pages
├── components/ # Reusable React components
│ ├── ui/ # Base UI components
│ └── ... # Feature-specific components
├── data/ # Static data files
├── hooks/ # Custom React hooks
├── lib/ # Utility functions and AI integration
└── public/ # Static assets
This project is licensed under the MIT License - see the LICENSE file for details.
Explore the rich tapestry of human culture through Ritual-AI - where tradition meets technology. 🌍✨