Skip to content

CODEEX AI is a 100% free AI platform featuring 35+ models from leading providers (Groq, Google Gemini, Cerebras, Hugging Face). Built by Heoster (Harsh), a 16-year-old developer from Khatauli, Uttar Pradesh, India, with a vision to democratize AI education and make advanced technology accessible to every student

License

Notifications You must be signed in to change notification settings

Heoster/CodeEx-AI-

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

33 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

CODEEX - Free AI Chat with 35+ Models

CODEEX

Free AI chat platform with Groq, Gemini, Cerebras, DeepSeek - No signup required

Build Status License PRs Welcome Made with Love

Live Demo (Netlify) โ€ข Live Demo (Vercel) โ€ข Documentation โ€ข Report Bug โ€ข Request Feature


๐ŸŒŸ About CODEEX

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.

๐ŸŽฏ Mission

"Making powerful AI accessible to everyone, everywhere, for free."

๐Ÿ“Š Platform Stats

  • ๐Ÿค– 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+

โœจ Features

๐Ÿค– AI Models (35+)

Groq (Lightning Fast)

  • Llama 3.1 8B Instant
  • Llama 3.1 70B Versatile
  • Llama 3.3 70B Versatile
  • Mixtral 8x7B
  • Gemma 2 9B

Google Gemini (Advanced)

  • Gemini 2.5 Flash (1M context)
  • Gemini 2.5 Flash-8B
  • Gemini 2.0 Flash Experimental

Cerebras (Ultra Fast)

  • Llama 3.1 8B
  • Llama 3.3 70B
  • Qwen 3 235B Instruct
  • Qwen 3 32B
  • GLM 4.7
  • GPT-OSS

Hugging Face (Specialized)

  • DeepSeek R1
  • DeepSeek R1 Distill Llama 70B
  • RNJ-1
  • And more...

๐ŸŽจ Core Features

๐Ÿ’ฌ AI Chat

  • Real-time streaming responses
  • 35+ model selection
  • Smart auto-routing
  • Context-aware conversations
  • Code syntax highlighting
  • Math equation rendering (KaTeX)

๐Ÿ” Web Search

  • Privacy-first search integration
  • AI-powered answer synthesis
  • Source citations
  • Real-time results

๐Ÿ“„ PDF Analysis

  • Upload PDFs up to 5MB
  • Intelligent document Q&A
  • Text extraction
  • Summary generation

๐Ÿ–ผ๏ธ Image Equation Solver

  • Upload images up to 5MB
  • Mathematical equation recognition
  • Step-by-step solutions
  • Visual problem solving

๐ŸŽค Voice Features

  • Text-to-Speech (Edge TTS)
  • Multiple voice options
  • Browser TTS fallback
  • Symbol filtering for natural speech

๐Ÿ“ Smart Notes

  • AI-powered note-taking
  • Six Souls workflow
  • Automatic organization
  • Export capabilities

๐ŸŽฏ Advanced Features

  • Share & Export (TXT, MD, PDF)
  • Regenerate responses
  • Copy to clipboard
  • Dark/Light theme
  • Mobile-optimized PWA
  • Offline support
  • Real-time thinking animation

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+ or higher
  • npm or yarn
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/heoster/codeex-ai.git
    cd codeex-ai
  2. Install dependencies

    npm install
  3. Set up environment variables

    cp .env.example .env.local
  4. Configure your API keys (see API Keys Setup)

  5. Run development server

    npm run dev
  6. Open your browser

    http://localhost:3000
    

๐Ÿ”‘ API Keys Setup

Required API Keys (All FREE)

1. Groq API (Required)

  • 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

2. Google Gemini API (Required)

3. Hugging Face API (Required)

4. Cerebras API (Optional)

5. Firebase (Required for Auth)

  • 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

6. EmailJS (Optional for Contact Form)

  • 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

Environment Variables Template

See .env.example for complete template with all required variables.


๐Ÿ› ๏ธ Tech Stack

Frontend

  • 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

Backend

  • Runtime: Node.js
  • API Routes: Next.js API Routes
  • Database: Firebase Firestore
  • Authentication: Firebase Auth
  • File Storage: Firebase Storage

AI Integration

  • Groq: Lightning-fast inference
  • Google Gemini: Advanced reasoning
  • Cerebras: Ultra-fast processing
  • Hugging Face: Specialized models
  • Custom Adapters: Multi-provider architecture

DevOps

  • Deployment: Netlify
  • Version Control: Git/GitHub
  • CI/CD: Netlify Auto-deploy
  • Monitoring: Built-in error tracking

๐Ÿ“ฑ Progressive Web App (PWA)

CODEEX AI is a fully-featured PWA that works on all devices:

Installation

๐Ÿ“ฑ iPhone/iPad

  1. Open in Safari
  2. Tap Share button
  3. Select "Add to Home Screen"
  4. Tap "Add"

๐Ÿค– Android

  1. Open in Chrome
  2. Tap install banner
  3. Or: Menu โ†’ "Install app"

๐Ÿ’ป Windows/Mac

  1. Open in Chrome/Edge
  2. Click install icon in address bar
  3. Or: Menu โ†’ "Install CODEEX AI"

PWA Benefits

  • โšก 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

PWA Documentation

Complete PWA guides available in /docs/:


๐Ÿ—๏ธ Project Structure

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

Available Scripts

# 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

Code Quality

  • TypeScript: Full type safety
  • ESLint: Code linting
  • Prettier: Code formatting
  • Husky: Git hooks (optional)

๐Ÿš€ Deployment

Netlify (Recommended)

  1. Connect Repository

    • Go to Netlify
    • Click "New site from Git"
    • Connect your GitHub repository
  2. Configure Build

    Build command: npm run build
    Publish directory: .next
    
  3. Add Environment Variables

    • Go to Site settings โ†’ Environment variables
    • Add all variables from .env.local
  4. Deploy

    • Click "Deploy site"
    • Automatic deployments on git push

Vercel

  1. Import Project

    • Go to Vercel
    • Click "Import Project"
    • Connect GitHub repository
  2. Configure

    • Framework: Next.js
    • Add environment variables
  3. Deploy

    • Automatic deployment

Custom Server

# Build
npm run build

# Start
npm run start

# Or use PM2
pm2 start npm --name "codeex-ai" -- start

๐Ÿ“Š Performance

Lighthouse Scores

  • Performance: 95+
  • Accessibility: 100
  • Best Practices: 100
  • SEO: 100
  • PWA: โœ“ Installable

Metrics

  • 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

Optimizations

  • Code splitting
  • Image optimization
  • Font optimization
  • Service worker caching
  • Edge function deployment
  • CDN distribution

๐Ÿ”’ Security

Best Practices

  • โœ… 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

Firebase Security

  • Firestore security rules
  • Authentication required
  • Role-based access control

๐Ÿค Contributing

We welcome contributions! Here's how:

  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Make your changes
  4. Commit your changes
    git commit -m 'Add amazing feature'
  5. Push to the branch
    git push origin feature/amazing-feature
  6. Open a Pull Request

Contribution Guidelines

  • Follow TypeScript best practices
  • Add tests for new features
  • Update documentation
  • Follow existing code style
  • Write clear commit messages

๐Ÿ‘จโ€๐Ÿ’ป About the Developer

Heoster (Harsh)

  • Age: 16 years old
  • Location: Khatauli, Uttar Pradesh, India
  • Education: Class 11 PCM, Maples Academy
  • Role: Founder & Lead Developer, CODEEX AI

Vision

"To democratize AI education in India and make advanced technology accessible to every student, regardless of their background or resources."

Achievements

  • 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

Connect


๐Ÿ“š Documentation

Main Docs

PWA Docs

Platform Specific


๐Ÿ› Troubleshooting

Common Issues

Build Errors

# Clear cache and rebuild
rm -rf .next node_modules
npm install
npm run build

API Key Issues

  • Verify all keys in .env.local
  • Check key format (no quotes needed)
  • Ensure keys are active

Firebase Issues

  • Check Firebase project settings
  • Verify Firestore rules
  • Enable required services

PWA Not Installing

  • Must be served over HTTPS
  • Check manifest.json
  • Verify service worker registration

Getting Help


๐Ÿ“„ License

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

MIT License Summary

  • โœ… Commercial use
  • โœ… Modification
  • โœ… Distribution
  • โœ… Private use
  • โŒ Liability
  • โŒ Warranty

๐Ÿ™ Acknowledgments

AI Providers

Technologies

Community

  • All contributors and testers
  • Open source community
  • Early adopters and users
  • Friends who provided feedback

๐ŸŒŸ Star History

If you find CODEEX AI useful, please consider giving it a star โญ

Star History Chart


๐Ÿ“ˆ Roadmap

Current (v2.0)

  • โœ… 35+ AI models
  • โœ… Multi-provider architecture
  • โœ… PWA support
  • โœ… Voice synthesis
  • โœ… PDF analysis
  • โœ… Image solver

Upcoming (v2.1)

  • ๐Ÿ”„ Native mobile apps (iOS/Android)
  • ๐Ÿ”„ Advanced voice features
  • ๐Ÿ”„ Collaborative features
  • ๐Ÿ”„ API marketplace
  • ๐Ÿ”„ Plugin system

Future (v3.0)

  • ๐Ÿ“‹ AI model training
  • ๐Ÿ“‹ Custom model fine-tuning
  • ๐Ÿ“‹ Enterprise features
  • ๐Ÿ“‹ White-label solution
  • ๐Ÿ“‹ Educational curriculum

๐Ÿ’– Support the Project

Ways to Support

  • โญ Star the repository
  • ๐Ÿ› Report bugs
  • ๐Ÿ’ก Suggest features
  • ๐Ÿ“ Improve documentation
  • ๐Ÿ”€ Submit pull requests
  • ๐Ÿ“ข Share with others
  • ๐Ÿ’ฌ Join discussions

Spread the Word

  • Share on social media
  • Write blog posts
  • Create tutorials
  • Make videos
  • Give talks

Built with โค๏ธ by a 16-year-old for the AI community

Netlify โ€ข Vercel โ€ข GitHub โ€ข LinkedIn โ€ข Twitter

ยฉ 2024-2026 CODEEX AI. All rights reserved.

Made in ๐Ÿ‡ฎ๐Ÿ‡ณ India with passion for democratizing AI education

About

CODEEX AI is a 100% free AI platform featuring 35+ models from leading providers (Groq, Google Gemini, Cerebras, Hugging Face). Built by Heoster (Harsh), a 16-year-old developer from Khatauli, Uttar Pradesh, India, with a vision to democratize AI education and make advanced technology accessible to every student

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published