Skip to content

AI-powered document analysis platform with vintage aesthetics. Upload documents and chat with your files using advanced AI.

Notifications You must be signed in to change notification settings

CodewithEvilxd/IntelliRead-AI

Repository files navigation

IntelliRead AI πŸ€–

License: MIT TypeScript React Tailwind CSS

πŸš€ Quick Deploy

Deploy to Vercel Deploy with Netlify

2025 Edition - Revolutionizing document analysis with cutting-edge AI technology and timeless vintage design. Transform how you interact with documents through intelligent conversations and instant insights.

AI-powered document analysis platform with vintage aesthetics. Upload documents and chat with your files using advanced AI.

✨ Features

πŸ€– AI Chat Interface - Natural conversation about your document content using Groq's Meta Llama models πŸ“„ Multi-Format Support - Process PDFs, Word docs, PowerPoint presentations, and text files ⚑ Instant Analysis - Get insights and answers in seconds with lightning-fast processing 🎨 Beautiful Design - Vintage black & white aesthetic with glass effects and smooth animations πŸ“± Fully Responsive - Works perfectly on desktop, tablet, and mobile devices πŸ”’ Secure & Private - Your documents stay private and secure with robust encryption πŸš€ 2025 Ready - Built with the latest technologies for future-proof performance

πŸ› οΈ Tech Stack

  • Frontend: React 19 + TypeScript for type-safe, modern development
  • Styling: Tailwind CSS with custom vintage design system and glass effects
  • AI: Groq SDK with Meta Llama models (3-key failover system for reliability)
  • Document Processing: PDF.js, Mammoth.js, and custom text extraction for multiple formats
  • Build: Vite with SWC for lightning-fast compilation and hot reloading
  • Fonts: Inter + Space Grotesk for modern, readable typography
  • Icons: Lucide React for consistent, beautiful iconography

πŸš€ Quick Deploy

One-Click Deploy

Click the buttons below to deploy your own instance of IntelliRead AI:

Deploy to Vercel Deploy with Netlify

Manual Setup

Prerequisites

  • Node.js 18+ and npm
  • Groq API key (get one at groq.com)

Installation

  1. Clone the repository
git clone https://github.com/your-username/intelli-read-ai.git
cd intelli-read-ai
  1. Install dependencies
npm install
  1. Set up environment variables
# Copy the example file
cp .env.example .env

# Edit .env and add your Groq API keys (up to 3 for failover)
VITE_GROQ_API_KEY_1=your_first_groq_api_key_here
VITE_GROQ_API_KEY_2=your_second_groq_api_key_here  # optional
VITE_GROQ_API_KEY_3=your_third_groq_api_key_here   # optional
  1. Start development server
npm run dev
  1. Open your browser Visit http://localhost:5173 to see IntelliRead AI in action! πŸŽ‰

πŸ“ Routes

  • / - Landing page with features showcase and vintage design
  • /chat - Interactive chat interface for document analysis
  • /about - About page with project information and statistics

Project Structure

src/
β”œβ”€β”€ components/          # React components
β”‚   β”œβ”€β”€ LandingPage.tsx  # Homepage with aesthetic elements
β”‚   └── Chat.tsx         # Chat interface (fully responsive)
β”œβ”€β”€ services/            # API integrations
β”‚   β”œβ”€β”€ groqService.ts   # AI chat functionality with 3-key failover
β”‚   β”œβ”€β”€ fileService.ts   # Multi-format document processing
β”‚   └── pdfService.ts    # Legacy PDF processing (deprecated)
β”œβ”€β”€ types/               # TypeScript type definitions
β”œβ”€β”€ utils/               # Utility functions & markdown parser
└── constants/           # Theme and configuration

🎯 Key Features Implemented

βœ… Responsive Design - Mobile-first approach with perfect scaling across all devices βœ… URL Routing - Clean navigation with /chat and /about routes βœ… Aesthetic Elements - Beautiful dotted lines, diagonal elements, and smooth animations βœ… Multi-Format Processing - PDF, Word, PowerPoint, and text file support with robust parsing βœ… AI Integration - Contextual conversations with 3-key failover system for reliability βœ… Modern Typography - Compact, readable fonts with perfect spacing and hierarchy βœ… Glass Effects - Premium visual effects throughout the interface with backdrop blur βœ… Button Hover States - All interactions work perfectly with smooth transitions βœ… 2025 Ready - Built with latest React 19, TypeScript, and modern web standards

⚑ Performance Optimizations

  • ⚑ Optimized bundle splitting for faster loading
  • πŸ—œοΈ Terser minification for smaller bundle sizes
  • 🧹 Cleaned up 70+ unused dependencies
  • πŸ“¦ Minimal build size with maximum functionality
  • πŸš€ Vite's fast HMR for development productivity

πŸ“Έ Screenshots

Coming soon - Beautiful screenshots showcasing the vintage design and AI chat interface

🀝 Contributing

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

How to Contribute

  1. Fork the project - Click the fork button on GitHub
  2. Clone your fork
git clone https://github.com/your-username/intelli-read-ai.git
cd intelli-read-ai
  1. Create your feature branch
git checkout -b feature/AmazingFeature
  1. Make your changes and test them thoroughly
  2. Commit your changes
git commit -m 'Add some AmazingFeature'
  1. Push to the branch
git push origin feature/AmazingFeature
  1. Open a Pull Request - We'll review and merge your contribution!

Development Guidelines

  • Follow the existing code style and TypeScript best practices
  • Add tests for new features
  • Update documentation as needed
  • Ensure all ESLint rules pass

πŸ“„ License

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

πŸ’‘ Recommended Component Libraries for Enhancement

Animation & Interactions

  • Framer Motion - Production-ready motion library for React
npm install framer-motion

UI Components & Icons

  • Radix UI - Unstyled, accessible UI primitives for buttons, dialogs, tooltips
npm install @radix-ui/react-dialog @radix-ui/react-dropdown-menu @radix-ui/react-tooltip
  • React Icons - Popular icon library with 24,000+ icons (alternative to Lucide)
npm install react-icons
  • Headless UI - Completely unstyled, fully accessible UI components (great for custom deploy buttons)
npm install @headlessui/react
  • Chakra UI - Simple, modular and accessible component library with beautiful button components
npm install @chakra-ui/react @emotion/react @emotion/styled framer-motion
  • Mantine - React components library with 100+ components including customizable buttons
npm install @mantine/core @mantine/hooks
  • Ant Design - Enterprise UI design language with polished deploy buttons
npm install antd

Enhanced Markdown & Code

  • React Markdown - Markdown component for React
  • React Syntax Highlighter - Syntax highlighting component
npm install react-markdown react-syntax-highlighter @types/react-syntax-highlighter

Form Handling

  • React Hook Form - Performant forms with easy validation
npm install react-hook-form @hookform/resolvers zod

State Management (if needed)

  • Zustand - Small, fast state management
npm install zustand

Built with ❀️ using modern web technologies. Perfect for document analysis workflows in 2025 and beyond!

About

AI-powered document analysis platform with vintage aesthetics. Upload documents and chat with your files using advanced AI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published