README.md

🤖 CODEEX AI v2.0

Next-Generation Multi-Provider AI Assistant

A powerful, intelligent AI assistant with smart routing, web search capabilities, and mobile-first design. Built with Next.js 14, featuring automatic fallback between AI providers and comprehensive document analysis.

🚀 Live Demo • 📖 Documentation • 🐛 Report Bug • 💡 Request Feature

---

✨ Features

🧠 AI Capabilities Multi-Provider Support - Groq + Google Gemini with smart routing Intelligent Fallback - Seamless switching when models are unavailable Web Search Integration - Real-time search with AI-powered synthesis Document Analysis - PDF processing and intelligent Q&A (5MB limit) Image Problem Solving - Mathematical equation recognition (5MB limit) Voice Synthesis - Text-to-speech with multiple voice options

🎨 User Experience Enhanced Mobile Selector - Search, swipe-to-dismiss, category filtering Real-time Chat - Instant AI responses with typing indicators Model Selection - Choose specific AI models or use auto-routing Dark/Light Theme - Automatic theme switching Progressive Web App - Install as native app on any device Offline Support - Works without internet connection

🔧 Technical Excellence

• ✅ 100% Free Models - No paid API dependencies
• ⚡ Smart Caching - Optimized performance and reduced API calls
• 🛡️ Error Handling - Graceful degradation and user-friendly messages
• 🔒 Type Safety - Full TypeScript implementation
• 🧪 Testing Suite - Comprehensive test coverage
• 📱 Mobile-First - Responsive design for all screen sizes

---

�️ Tiech Stack

Category	Technologies
Frontend
Styling
AI/ML
Backend
Testing

---

🤖 AI Models & Providers

🔥 Google Gemini Models (Free Tier: 15 req/min, 1500 req/day)

• Gemini 2.5 Flash - Latest model with enhanced performance and multimodal capabilities (1M context)

⚡ Groq Models (Free Tier: 14,400 req/day)

• Llama 3.1 70B - Most capable for complex reasoning (131K context)
• Llama 3.1 8B Instant - Lightning-fast conversations (131K context)
• Mixtral 8x7B - Excellent for code generation (32K context)
• Llama 3.2 90B - Advanced mathematical reasoning (131K context)

💡 All models are completely free with generous rate limits and automatic fallback between providers.

---

📱 Progressive Web App (PWA)

🚀 Insll CODEEX AI as a Native App

<ta``e>

iPhone/iPad
Safari → Share → "Add to Home Screen" Windows
Edge → ... → "Install this site as an app"

</

Groq (Required - FREE)

1.# ✨ PWA Benefits

• ⚡ 10-15x faster repeat loads with intelligent caching
• 📶 Works offline with cached content and conversations
• 🎯 Fun experience without browser UI
• 🔄 Auto-updates in background
• ⌨️ App shortcuts for quick actionsudio.google.com/app/apikey)

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• Free accounts: Groq, Google AI Studio, [Firebase](https://console.firebase.google.

1. Sign up at EmailJS 2.# Installation

# 1. Clone the repository
ne https://github.com/heoster/codeex-ai.git
cd codeex-ai

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .enple .env.local

# 4. Configure your API itHubee setuelow)

# 5. Run develoaticallyrver
npm run dev

# http://localhost:3000

🔑 API Keys Setup

Google Geminired - FREE)

1. Visit Google AI Studio
2. Create a new API key
3. Add to .env.local: GOOGLE_API_Key_here

Fiase (Required - FREE)

1. Create project at [Firebase Console](https://console.firebase.google
2. Enable Authentication and Firestore
3. Add configuration to .env.local

EmailJS (Optional -

1. Sign up at [EmailJS](https://www.emailjs.
## reaPte email service and templates
3. Add credentto `.env.local`

</details>
- `/api/ai/search` - Web search with AI-powered answers
---

## 📊 Permance & Metrics

<div align="cer">

| Metric | Score | Status |
|--------|-------|--------|
| **HTTPS ouse Performance** | ication Excellent |
| **Content Stentful Paint** | <1.5s | ✅ Fast |
| **Time to Interactive** | <2.5s | ✅ sive |
| **Bundle Size** | <200KB | ✅ Optimized |
| **Mobile Performance** | 3G Ready |Mobile-First |

</div>

---
- Provider rate limits and quotas
- Smart felopment & Testing for reliability

##`bash
# Development
npm run dev              # Start developmeserver
npm run build            # Build el organuction
npm run start            # Starty roduction server

# Testing
npm test                 # Run all tests
npm run test:watch       # Watch moderation
- **Real-est:coverage    # Coverage report

# Quality Asitatice
npm run lint             # ESL
#pm run typecheck        # TypeScript checking

--Multi-Format Support: Various document types

📚 API Endpoints

Endpoint	Description	Features
/api/ai/so	Problem solving	Math, coding, generations
/api/ai/search	Web search	AI-powered answers wces
/api/ai/summarizeymarization	Multiple styles and lengths
/api/ai/image-solver	Image analysis	Mathematical equation reco(5MB)
/api/ai/pdf-analyzer	Document analysis	PDFand Q&A (5MB)

---

� Seccurity & Privacy

• 🛡️ Server-Side API Keys - No sensitive data exposed to client
• 🔍 Input Validation - Comprehensive sanitizationtion

**cRate Limitinsilt-in protection against abuse

• 🔐 HTTPnly - Secure communication
• 🛡️ CSP Headers - Contentlightnity Policy for XSS protection
• 🔒 Pr AI](httpst - DuckDuckGo search integration

---

🚀 Deployment

🌐 Netlify (Recostrong>

1. Connect your GitHub repository to Netlify** - Production deployment

• *Set build command: `npm run build:ne- Andr

3. Set publish directory: `.next-setup.md)** - EmailJS configuration
4. Add environment variables from .env.example
5. Deploy automatically on every push

[](https:/etlify.com/start/deploy?retory=https://github.com/heoster/codeex-ai

• PWA Deployment - Deploy PWA
• *etails>

▲ Vercel

1. Import project from GitHub
2. Configure environment variables
3. Deploy with zero configuration

---

🤝 Contributing

We welcome contributions! Here's how you can help:

🛠️ Development Setup

1. Fork the repository
2. Clone your fork: git clone https://github.com/yourusername/codeex-ai.git
3. Create a feature branch: git checkout -b feature/amazing-feature
4. Install dependencies: npm install
5. Make your changes
6. Add tests for new features
7. Commit your changes: git commit -m 'Add amazing feature'
8. Push to the branch: git push origin feature/amazing-feature
9. Open a Pull Request

🎯 Areas for Contribution

• 🐛 Bug fixes and improvements
• ✨ New AI model integrations
• 📱 Mobile experience enhancements
• 🧪 Test coverage improvements
• 📖 Documentation updates
• 🌐 Internationalization (i18n)

---

📖 Documentation

Category	Links
📱 PWA	Quick Start • Testing Guide • Deployment
🚀 Deployment	Netlify Guide • Environment Setup
🔧 Development	Contributing • API Reference • Testing
📞 Support	Issues • Discussions

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

Special thanks to the amazing open-source community:

---

🌟 Star this repo if you find it helpful!

Built with ❤️ for the AI community

🚀 Try CODEEX AI Now • 📖 Read the Docs • 💬 Join Discussion