Your digital best friend powered by AI. A modern, full-stack chatbot with personality, built with Next.js and integrated with Pollinations AI for both text generation and image creation.
- 🤖 Intelligent Chat: Powered by DeepSeek-R1 via Pollinations AI
- 🎨 Image Generation: High-quality images with
/imaginecommands - 💫 Smooth Animations: GSAP-powered UI with custom animations
- 🎭 Personality: Pelvix has a warm, friendly, and witty personality
- 📱 Responsive Design: Works beautifully on all devices
- 🔄 Real-time Chat: Instant responses with typing indicators
- 🎨 Custom Themes: Beautiful dark theme with CSS variables
- 🛡️ Error Handling: Robust error boundaries and fallbacks
- ⚡ Performance: Optimized with Next.js 15 and React 19
# Clone the repository
git clone https://github.com/kedar49/Pelvix
cd PelVix
# Install dependencies
npm install
# Run development server
npm run devOpen http://localhost:3000 and start chatting with Pelvix!
Simply type your message and press Enter. Pelvix will respond with her characteristic warmth and wit.
User: How are you today?
Pelvix: Hey there! I'm doing fantastic, thanks for asking! 😊 Ready to dive into whatever's on your mind!
Use the /imagine command to generate stunning images:
/imagine a cute robot drinking coffee
/imagine a sunset over mountains --seed 123
/imagine a cyberpunk city --model flux
Supported Parameters:
--seed <number>: For reproducible results--model <name>: Specify AI model (default: flux)
- Framework: Next.js 15 with App Router
- Frontend: React 19, JavaScript/JSX
- Styling: CSS Modules with custom properties
- Animations: GSAP with React hooks
- AI Integration: Pollinations AI API
- Text Model: DeepSeek-R1
- Image Model: Flux (SDXL-based)
- Deployment: Vercel
- Typography: Geist Mono font
PelVix/
├── src/
│ ├── app/
│ │ ├── api/chat/ # API route for chat/image generation
│ │ ├── component/ # Reusable React components
│ │ ├── context/ # React context providers
│ │ ├── utils/ # Utility functions and GSAP config
│ │ ├── assets/ # Static assets (fonts, images)
│ │ ├── globals.css # Global styles and CSS variables
│ │ ├── layout.jsx # Root layout with providers
│ │ └── page.jsx # Main chat interface
├── public/ # Public static files
├── next.config.mjs # Next.js configuration
├── vercel.json # Vercel deployment config
└── package.json # Dependencies and scripts
- Chat Interface (
page.jsx): Main conversation UI - Message Animation (
messageAnim/): GSAP-powered text/image reveals - Input Component (
input/): Custom input with caret animation - Theme System: CSS custom properties for consistent theming
- Error Boundary: Graceful error handling throughout the app
- Connect your GitHub repository to Vercel
- Vercel will automatically detect Next.js and deploy
- No additional configuration needed!
# Build the project
npm run build
# Start production server
npm startnpm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
npm run clean # Clean build cacheThe app works out of the box with no environment variables required. All AI services are accessed through public APIs.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is open source and available under the MIT License.
Created by Kedar Sathe
Powered by:
- Pollinations AI - Free AI platform for text and images
- Next.js - React framework
- GSAP - Professional animation library
- Vercel - Deployment platform
- Live Demo: https://pelvix.vercel.app
- Developer: https://wtfkedar.vercel.app
- Technical Report: See TECHNICAL_REPORT.md
Made with ❤️ by Kedar Sathe