Free AI chat platform with Groq, Gemini, Cerebras, DeepSeek - No signup required
Live Demo (Netlify) โข Live Demo (Vercel) โข Documentation โข Report Bug โข Request Feature
CODEEX is a 100% free AI chat platform featuring 35+ models from leading providers: Groq (Llama 3.3 70B), Google Gemini 2.5, Cerebras (Qwen 3 235B), DeepSeek R1, and more. Chat, code, solve math, analyze PDFs - all without signup.
"Making powerful AI accessible to everyone, everywhere, for free."
- ๐ค 35+ AI Models across 4 providers
- ๐ฅ 1,000+ Daily Users worldwide
- ๐ 100+ Countries reached
- โก 99.9% Uptime reliability
- ๐ 50,000+ Lines of Code
- ๐จ 200+ Components
- ๐ Lighthouse Score 95+
- Llama 3.1 8B Instant
- Llama 3.1 70B Versatile
- Llama 3.3 70B Versatile
- Mixtral 8x7B
- Gemma 2 9B
- Gemini 2.5 Flash (1M context)
- Gemini 2.5 Flash-8B
- Gemini 2.0 Flash Experimental
- Llama 3.1 8B
- Llama 3.3 70B
- Qwen 3 235B Instruct
- Qwen 3 32B
- GLM 4.7
- GPT-OSS
- DeepSeek R1
- DeepSeek R1 Distill Llama 70B
- RNJ-1
- And more...
- Real-time streaming responses
- 35+ model selection
- Smart auto-routing
- Context-aware conversations
- Code syntax highlighting
- Math equation rendering (KaTeX)
- Privacy-first search integration
- AI-powered answer synthesis
- Source citations
- Real-time results
- Upload PDFs up to 5MB
- Intelligent document Q&A
- Text extraction
- Summary generation
- Upload images up to 5MB
- Mathematical equation recognition
- Step-by-step solutions
- Visual problem solving
- Text-to-Speech (Edge TTS)
- Multiple voice options
- Browser TTS fallback
- Symbol filtering for natural speech
- AI-powered note-taking
- Six Souls workflow
- Automatic organization
- Export capabilities
- Share & Export (TXT, MD, PDF)
- Regenerate responses
- Copy to clipboard
- Dark/Light theme
- Mobile-optimized PWA
- Offline support
- Real-time thinking animation
- Node.js 18+ or higher
- npm or yarn
- Git
-
Clone the repository
git clone https://github.com/heoster/codeex-ai.git cd codeex-ai -
Install dependencies
npm install
-
Set up environment variables
cp .env.example .env.local
-
Configure your API keys (see API Keys Setup)
-
Run development server
npm run dev
-
Open your browser
http://localhost:3000
- Visit: https://console.groq.com/keys
- Create account (free)
- Generate API key
- Add to
.env.local:GROQ_API_KEY=gsk_your_key_here
- Free Tier: 14,400 requests/day
- Visit: https://aistudio.google.com/app/apikey
- Create account (free)
- Generate API key
- Add to
.env.local:GOOGLE_API_KEY=your_key_here
- Free Tier: 15 requests/min, 1,500 requests/day
- Visit: https://huggingface.co/settings/tokens
- Create account (free)
- Generate access token
- Add to
.env.local:HUGGINGFACE_API_KEY=hf_your_key_here
- Free Tier: Generous limits
- Visit: https://cloud.cerebras.ai
- Create account (free)
- Generate API key
- Add to
.env.local:CEREBRAS_API_KEY=your_key_here
- Visit: https://console.firebase.google.com
- Create new project (free)
- Enable Authentication & Firestore
- Get configuration from Project Settings
- Add to
.env.local:NEXT_PUBLIC_FIREBASE_API_KEY=your_key NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_domain NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_bucket NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id
- Visit: https://www.emailjs.com
- Create account (free)
- Set up email service
- Add to
.env.local:NEXT_PUBLIC_EMAILJS_SERVICE_ID=your_service_id NEXT_PUBLIC_EMAILJS_TEMPLATE_ID=your_template_id NEXT_PUBLIC_EMAILJS_PUBLIC_KEY=your_public_key
See .env.example for complete template with all required variables.
- Framework: Next.js 14 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS
- UI Components: shadcn/ui
- Icons: Lucide React
- Animations: Framer Motion
- Math Rendering: KaTeX
- Markdown: react-markdown
- Runtime: Node.js
- API Routes: Next.js API Routes
- Database: Firebase Firestore
- Authentication: Firebase Auth
- File Storage: Firebase Storage
- Groq: Lightning-fast inference
- Google Gemini: Advanced reasoning
- Cerebras: Ultra-fast processing
- Hugging Face: Specialized models
- Custom Adapters: Multi-provider architecture
- Deployment: Netlify
- Version Control: Git/GitHub
- CI/CD: Netlify Auto-deploy
- Monitoring: Built-in error tracking
CODEEX AI is a fully-featured PWA that works on all devices:
- Open in Safari
- Tap Share button
- Select "Add to Home Screen"
- Tap "Add"
- Open in Chrome
- Tap install banner
- Or: Menu โ "Install app"
- Open in Chrome/Edge
- Click install icon in address bar
- Or: Menu โ "Install CODEEX AI"
- โก 10-15x faster repeat loads
- ๐ถ Works offline with cached content
- ๐ฏ Fullscreen experience (no browser UI)
- ๐ Auto-updates in background
- ๐ Home screen icon
- โจ๏ธ App shortcuts for quick actions
Complete PWA guides available in /docs/:
- PWA README - Quick start
- PWA Deployment - Deploy guide
- PWA Testing - Test procedures
- PWA Verification - Technical details
codeex-ai/
โโโ src/
โ โโโ app/ # Next.js app router
โ โ โโโ api/ # API routes
โ โ โโโ chat/ # Chat interface
โ โ โโโ documentation/ # Docs pages
โ โ โโโ ...
โ โโโ components/ # React components
โ โ โโโ chat/ # Chat components
โ โ โโโ ui/ # UI components (shadcn)
โ โ โโโ ...
โ โโโ lib/ # Utilities & configs
โ โ โโโ ai/ # AI adapters
โ โ โโโ models-config.json # Model definitions
โ โ โโโ ...
โ โโโ hooks/ # Custom React hooks
โ โโโ styles/ # Global styles
โโโ public/ # Static assets
โ โโโ icons/ # PWA icons
โ โโโ manifest.json # PWA manifest
โ โโโ sw.js # Service worker
โโโ docs/ # Documentation
โโโ .env.example # Environment template
โโโ next.config.js # Next.js config
โโโ tailwind.config.ts # Tailwind config
โโโ package.json # Dependencies
# Development
npm run dev # Start dev server (localhost:3000)
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
npm run typecheck # TypeScript type checking
# Testing
npm test # Run tests
npm run test:watch # Watch mode
npm run test:coverage # Coverage report
# Utilities
npm run clean # Clean build artifacts
npm run format # Format code with Prettier- TypeScript: Full type safety
- ESLint: Code linting
- Prettier: Code formatting
- Husky: Git hooks (optional)
-
Connect Repository
- Go to Netlify
- Click "New site from Git"
- Connect your GitHub repository
-
Configure Build
Build command: npm run build Publish directory: .next -
Add Environment Variables
- Go to Site settings โ Environment variables
- Add all variables from
.env.local
-
Deploy
- Click "Deploy site"
- Automatic deployments on git push
-
Import Project
- Go to Vercel
- Click "Import Project"
- Connect GitHub repository
-
Configure
- Framework: Next.js
- Add environment variables
-
Deploy
- Automatic deployment
# Build
npm run build
# Start
npm run start
# Or use PM2
pm2 start npm --name "codeex-ai" -- start- Performance: 95+
- Accessibility: 100
- Best Practices: 100
- SEO: 100
- PWA: โ Installable
- First Contentful Paint: <1.5s
- Time to Interactive: <2.5s
- Largest Contentful Paint: <2.5s
- Cumulative Layout Shift: <0.1
- Total Bundle Size: <200KB gzipped
- Code splitting
- Image optimization
- Font optimization
- Service worker caching
- Edge function deployment
- CDN distribution
- โ All API keys server-side only
- โ Input validation & sanitization
- โ Rate limiting on API routes
- โ HTTPS only (enforced)
- โ Content Security Policy
- โ XSS protection
- โ CSRF protection
- โ Secure headers
- Firestore security rules
- Authentication required
- Role-based access control
We welcome contributions! Here's how:
- Fork the repository
- Create a feature branch
git checkout -b feature/amazing-feature
- Make your changes
- Commit your changes
git commit -m 'Add amazing feature' - Push to the branch
git push origin feature/amazing-feature
- Open a Pull Request
- Follow TypeScript best practices
- Add tests for new features
- Update documentation
- Follow existing code style
- Write clear commit messages
- Age: 16 years old
- Location: Khatauli, Uttar Pradesh, India
- Education: Class 11 PCM, Maples Academy
- Role: Founder & Lead Developer, CODEEX AI
"To democratize AI education in India and make advanced technology accessible to every student, regardless of their background or resources."
- Built CODEEX AI with 35+ models at age 16
- 50,000+ lines of code written
- 200+ components developed
- 1,000+ daily users worldwide
- 100+ countries reached
- 99.9% uptime maintained
- ๐ง Email: the.heoster@mail.com
- ๐ผ LinkedIn: codeex-heoster
- ๐ GitHub: @heoster
- ๐ฆ Twitter: @The_Heoster_
- ๐ธ Instagram: @heoster_official
# Clear cache and rebuild
rm -rf .next node_modules
npm install
npm run build- Verify all keys in
.env.local - Check key format (no quotes needed)
- Ensure keys are active
- Check Firebase project settings
- Verify Firestore rules
- Enable required services
- Must be served over HTTPS
- Check manifest.json
- Verify service worker registration
- ๐ Check Documentation
- ๐ Report Issues
- ๐ฌ Join Discussions
- ๐ง Email: the.heoster@mail.com
This project is licensed under the MIT License - see the LICENSE file for details.
- โ Commercial use
- โ Modification
- โ Distribution
- โ Private use
- โ Liability
- โ Warranty
- Groq - Lightning-fast AI inference
- Google AI - Advanced Gemini models
- Cerebras - Ultra-fast processing
- Hugging Face - Specialized models
- Next.js - React framework
- Tailwind CSS - Utility-first CSS
- shadcn/ui - Beautiful components
- Lucide - Icon library
- Firebase - Backend services
- Netlify - Deployment platform
- All contributors and testers
- Open source community
- Early adopters and users
- Friends who provided feedback
If you find CODEEX AI useful, please consider giving it a star โญ
- โ 35+ AI models
- โ Multi-provider architecture
- โ PWA support
- โ Voice synthesis
- โ PDF analysis
- โ Image solver
- ๐ Native mobile apps (iOS/Android)
- ๐ Advanced voice features
- ๐ Collaborative features
- ๐ API marketplace
- ๐ Plugin system
- ๐ AI model training
- ๐ Custom model fine-tuning
- ๐ Enterprise features
- ๐ White-label solution
- ๐ Educational curriculum
- โญ Star the repository
- ๐ Report bugs
- ๐ก Suggest features
- ๐ Improve documentation
- ๐ Submit pull requests
- ๐ข Share with others
- ๐ฌ Join discussions
- Share on social media
- Write blog posts
- Create tutorials
- Make videos
- Give talks
