🚀CappyChat

Next-Generation AI Chat Platform

🎯 High-Performance • 🔄 Real-Time Sync • 🤖 25+ AI Models • ⚡ Sub-100ms Response

🌐 Live Demo • 📚 Documentation • 🔧 API Reference • 🤝 Contributing

</div>

🎉 What's New in v4.1.0

Plan Mode & Advanced Features - CappyChat v4.1.0 introduces Plan Mode for creating interactive diagrams and visualizations, enhanced observability with Better Stack logging, and persistent guest rate limiting with Upstash Redis.

🌟 Highlights:

🧠 Plan Mode with AI Artifacts - Create interactive diagrams, flowcharts, and visualizations using Mermaid
🌐 URL Retrieval Tool - Comprehensive web content analysis with live crawling and AI summaries
🛡️ Upstash Redis Rate Limiting - Persistent guest rate limiting across serverless functions
📊 Better Stack Logging - Enhanced observability with structured logging across all API endpoints
📄 PDF Thumbnail Preview - Better file visualization and management
🎨 Enhanced Image Generation - New models for improved visual content creation

📋 View Full Changelog • 🚀 Upgrade Guide

📖 Overview

CappyChat is a cutting-edge AI chat platform engineered for performance, scalability, and seamless user experience. Built with a local-first architecture, it delivers instant responses while maintaining data consistency across devices through intelligent cloud synchronization.

✨ Key Highlights

🤖 AI Excellence

30+ Premium Models - GPT-5, Gemini 2.5, Claude 4, Grok 4, DeepSeek, Qwen
Intelligent Routing - Automatic model selection based on query type
BYOK Support - Enhanced privacy with your own API keys
Tiered Access - Free, premium, and super-premium model tiers

</td> <td width="50%">

⚡ Performance

Sub-100ms Response - Local-first operations with optimistic updates
Real-time Sync - Instant synchronization across all devices
Hybrid Architecture - IndexedDB + Appwrite cloud integration
106kB Bundle - Highly optimized with dynamic imports

</td> </tr> <tr> <td width="50%">

🎨 Advanced Features

Plan Mode - Interactive diagrams and visualizations with Mermaid syntax
Image Generation - Google Gemini 2.5 Flash Image Preview (nano banana)
Voice Input - OpenAI Whisper speech-to-text integration
Web Search - Intelligent tool calling with Parallel AI, Tavily, and Exa
File Upload - Multi-format support with AI analysis, PDF thumbnails, and pagination

</td> <td width="50%">

🔧 Developer Experience

Modern Stack - Next.js 15, React 19, TypeScript, TailwindCSS
Real-time Features - WebSocket connections with Appwrite
Observability - Better Stack logging for enhanced monitoring
Production Ready - Deployed at cappychat.com
99.9% Uptime - Enterprise-grade reliability

</td> </tr> </table>

👥 Team

</div>

🌟 Features

Comprehensive AI Platform with Enterprise-Grade Performance

</div> <details> <summary><strong>🤖 Multi-Model AI Support</strong></summary> <br>

| Feature | Description | Models | | ---------------------- | ------------------------------------------- | --------------------------------------------- | | Premium Models | Latest AI models with advanced capabilities | GPT-5, Claude 4, Grok 4 | | Fast Models | Optimized for speed and efficiency | Gemini 2.5 Flash Lite, OpenAI 5 Mini, Grok 4 Fast | | Specialized Models | Task-specific AI models | DeepSeek R1, Qwen3 Max, Claude Sonnet 3.7 | | Image Models | Advanced image generation | Gemini 2.5 Flash Image Preview (nano banana) |

Key Benefits:

🎯 Intelligent Routing - Automatic model selection based on query complexity
🔐 BYOK Support - Enhanced privacy with your own API keys
💳 Flexible Pricing - Tiered access with free, premium, and super-premium models
🔄 Model Switching - Seamless switching between models mid-conversation

</details> <details> <summary><strong>⚡ Performance & Architecture</strong></summary> <br>

graph LR
    A[User Input] --> B[Local Storage]
    B --> C[Instant UI Update]
    B --> D[Background Sync]
    D --> E[Cloud Database]
    E --> F[Real-time Broadcast]
    F --> G[Other Devices]

Performance Metrics:

⚡ Sub-100ms local operations
📦 106kB optimized bundle size
🔄 99.9% sync reliability
📱 Mobile-first responsive design

Architecture Highlights:

🏠 Local-First Design - IndexedDB for instant responses
☁️ Hybrid Database - Appwrite cloud synchronization
🔄 Optimistic Updates - Immediate UI feedback
📊 Smart Caching - Intelligent cache management

</details> <details> <summary><strong>🎨 Advanced Capabilities</strong></summary> <br>

| Capability | Technology | Features | | -------------------- | ----------------------------------- | ----------------------------------------------- | | Plan Mode | Mermaid + AI Artifacts | Interactive diagrams, Flowcharts, Visualizations | | Image Generation | Gemini 2.5 Flash Image Preview | Text-to-image, Context-aware generation | | Voice Input | OpenAI Whisper | Multi-language, Real-time transcription | | Web Search | Parallel AI + Tavily + Exa | Intelligent tool calling, Rich citations, Website retrieval | | File Upload | Cloudinary | Images, PDFs with thumbnails, Documents with AI analysis | | Collaboration | Real-time sync | Team workspaces, Member management | | Observability | Better Stack + Upstash Redis | Structured logging, Persistent rate limiting |

Advanced Features:

🧠 Plan Mode - Create diagrams, flowcharts, and MVPs with AI assistance
🎭 Conversation Styles - Balanced, creative, precise modes
🧠 Global Memory - Persistent context across conversations
💬 Suggested Questions - AI-powered conversation suggestions
📊 Analytics - Usage tracking and insights with Better Stack
🔗 Share & Export - Public sharing and data export
🛡️ Rate Limiting - Persistent guest rate limiting with Upstash Redis

</details> <details> <summary><strong>🔧 Developer Experience</strong></summary> <br>

Modern Technology Stack:

const techStack = {
  frontend: ["Next.js 15", "React 19", "TypeScript 5.8", "TailwindCSS 4.1"],
  backend: ["Node.js", "Appwrite", "API Routes"],
  database: ["IndexedDB", "Appwrite Cloud", "Real-time Sync", "Upstash Redis"],
  deployment: ["Vercel", "Docker", "CDN"],
  monitoring: ["Better Stack", "Analytics", "Error Tracking", "Performance Metrics"],
};

Developer Tools:

🛠️ TypeScript - Full type safety with strict mode
🎨 Component Library - Shadcn/ui + Radix UI primitives
📦 State Management - Zustand for efficient state handling
🔐 Authentication - Appwrite Auth with OAuth providers
👑 Admin Panel - Comprehensive system management

</details>

🛠️ Technology Stack

Built with Modern, Production-Ready Technologies

</div> <table> <tr> <td width="50%">

🎨 Frontend

{
  "framework": "Next.js 15.3",
  "runtime": "React 19",
  "language": "TypeScript 5.8",
  "styling": "TailwindCSS 4.1",
  "components": "Shadcn/ui + Radix",
  "state": "Zustand",
  "routing": "React Router 7.6",
  "forms": "React Hook Form + Zod"
}

🔧 Development

{
  "packageManager": "pnpm",
  "buildTool": "Turbopack",
  "linting": "ESLint + Next.js",
  "formatting": "Prettier",
  "versioning": "Semantic + Changelog"
}

</td> <td width="50%">

⚙️ Backend & APIs

{
  "runtime": "Node.js",
  "framework": "Next.js API Routes",
  "database": "Appwrite Cloud",
  "auth": "Appwrite + OAuth",
  "storage": "Cloudinary",
  "ai": ["OpenRouter", "OpenAI", "Google Gemini"],
  "search": ["Parallel AI", "Tavily", "Exa"],
  "payments": "DODO Payments",
  "logging": "Better Stack",
  "rateLimit": "Upstash Redis"
}

CappyChat

Install / Use

README

🚀CappyChat

Next-Generation AI Chat Platform

🎉 What's New in v4.1.0

📖 Overview

✨ Key Highlights

👥 Team

🌟 Features

Comprehensive AI Platform with Enterprise-Grade Performance

🛠️ Technology Stack

Built with Modern, Production-Ready Technologies

🎨 Frontend

🔧 Development

⚙️ Backend & APIs

**💾