Welcome to x00chat - Where AI meets productivity, and your digital life finally gets the upgrade it deserves! 🚀 Think of it as your personal AI butler, but instead of bringing you tea, it automates your entire workflow while you binge-watch Netflix. ☕

• 🔮 The Open-Source Crystal Ball - All the magic of premium AI tools, but open-source so you can peek behind the curtain (and fix our bugs) 🐛
• 🤖 Your Digital Sidekick - Like having JARVIS, but less British and more likely to help you organize your Gmail instead of saving the world 🦾
• 🕸️ Web of Integrations - Connect everything from Gmail to GitHub - basically Spider-Man's web, but for productivity nerds 🕷️
• ⏰ Background Agent Army - Deploy AI minions that work while you sleep. Finally, automation that doesn't require a CS degree! 👾
• 🧠 AI Model Buffet - 40+ models to choose from. It's like Pokémon, but for language models (gotta catch 'em all!) 🎮
• 🎨 Personality Plus - Customize your AI's personality because vanilla is for ice cream, not assistants 🍦
• 🔐 Fort Knox Security - Open source + self-hostable = your data stays where you want it (hint: not in some random server farm) 🏰

• Smart Worker Bees 🐝 - Set up agents to buzz around and get stuff done on schedules
• Email Updates 📧 - Get notified when your digital workforce completes missions
• Cron Jobs, But Fun ⏲️ - Daily, weekly, or "whenever Mercury isn't in retrograde" scheduling
• Mission Control 🎮 - Track your agents like you're running NASA (minus the rocket science)
• Pause & Resume ⏸️ - Because sometimes even robots need a coffee break

• Gmail Mastery 📮 - Read, write, and organize emails like a digital Marie Kondo
• Google Calendar 📅 - Schedule meetings without the existential dread of double-booking
• Google Drive & Docs 📄 - Access files faster than you can say "Where did I save that?"
• Notion Ninja 📓 - Your second brain, now with AI-powered telepathy
• GitHub Guru 👨‍💻 - Manage repos without leaving your chat (because context switching is the enemy)
• Slack Whisperer 💬 - Send messages that actually get responses
• Linear Logic 📊 - Project management that doesn't make you want to flip tables
• Twitter/X Commander 🐦 - Tweet into the void, but strategically
• And 10+ More! 🎪 - We're basically the Swiss Army knife of integrations

• 40+ AI Models 🎭 - More variety than a Netflix catalog, and actually useful
• Multi-Modal Magic 🎨 - Text, images, and enough reasoning to make philosophers jealous
• Image Generation 🖼️ - Create art that would make DALL-E weep tears of joy
• Reasoning Models 🤔 - Watch AI think harder than you did in calculus class
• Model Hot-Swapping 🔄 - Switch between AIs like changing TV channels (but educational)
• Web Search Powers 🔍 - Real-time internet knowledge without the rabbit holes

• Smart Organization 🗂️ - Auto-sorting that would make a librarian proud
• Pin The Important Stuff 📌 - Like bookmarks, but for conversations that actually matter
• Chat Branching 🌳 - Explore alternative timelines in your conversations (multiverse theory, anyone?)
• Search That Actually Works 🔎 - Find that one conversation from three months ago in milliseconds
• Bulk Operations ⚡ - Manage multiple chats like a database admin with superpowers
• Data Freedom 📤 - Export/import everything because vendor lock-in is so 2020

• Responsive Magic 📱 - Works on everything from your phone to that ultrawide monitor you definitely need
• Sidebar Sorcery 🎭 - Collapsible, searchable, and more organized than your sock drawer
• Theme Therapy 🌙 - Dark mode for vampires, light mode for the brave
• Keyboard Ninja Moves ⌨️ - Shortcuts that'll make you feel like a terminal wizard
• Real-Time Everything ⚡ - Streaming responses faster than your Twitter doom-scrolling
• Mobile-First Design 📲 - Because productivity shouldn't stop at your desk

• AI Personality Designer 🎭 - Make your assistant as quirky or professional as you want
• Settings Galore ⚙️ - More configuration options than a Linux distro
• Usage Tracking 📊 - Know exactly how much you're chatting (spoiler: it's a lot)
• API Key Fort Knox 🔐 - Your keys stay encrypted and safe from prying eyes
• Prompt Inspiration 💡 - When writer's block hits your conversations

• Payment Processing 💳 - Polar integration smoother than a fresh git merge
• Premium Model Access 🎫 - The VIP lounge of AI models

• OpenAI Squad: GPT-5, GPT-4o, o3 Pro (the overachievers) 🧠
• Anthropic Crew: Claude 4 Opus, Claude 3.5 Sonnet (the philosophers) 🎭
• Google Gang: Gemini 2.5 Pro, Gemini Flash (the search experts) 🔍
• Meta Squad: Llama 4 variants (the social butterflies) 🦙
• Mistral Team: Pixtral Large (the French connection) 🥐
• DeepSeek Division: V3.1 with reasoning (the deep thinkers) 🤔
• xAI Collective: Grok models (the witty ones) 😏
• Plus More: Moonshot, zAI, Qwen (the international crew) 🌍

• OpenAI: GPT Image 1 (the precision painter) 🎨
• Google: Imagen 4 Ultra (the detail master) 🖼️
• Fal: Flux Schnell (the speed demon) ⚡

Built with the finest tools that money can't buy (because they're open source):

• Next.js - React, but with superpowers 🦸‍♂️
• prompt-kit - AI components prettier than CSS Grid 💄
• shadcn/ui - Components so good, they're basically cheating 🎯
• motion-primitives - Animations smoother than jazz 🎵
• Vercel AI SDK - The AI Swiss Army knife 🔧
• Convex - Real-time backend magic ✨
• Cloudflare R2 - File storage that doesn't break the bank 💰
• Polar - Payments without the payment nightmares 💳
• Phosphor Icons - Icons so beautiful, they deserve their own museum 🖼️
• Tailwind CSS - CSS that doesn't make you cry 😭

• Project Workspaces 📁 - Organize like a boss, not like your desktop
• MCP Integration 🔌 - Model Context Protocol (because protocols are cool)
• More Agent Powers 🤖 - Background agents that might achieve sentience (kidding... maybe)

• Image Generation 🎨 - Now with 200% more pixels and 50% more "wow"
• Advanced Search 🔍 - Find things faster than Google (don't tell them we said that)
• Payment Magic 💰 - Polar integration that actually works on first try
• Settings Overhaul ⚙️ - More options than a gaming PC configurator
• Chat Branching 🌿 - Multiverse conversations are finally here
• Reasoning Visuals 🧠 - Watch AI think in real-time (it's oddly mesmerizing)
• Mobile Perfection 📱 - Mobile experience smoother than butter on toast

• Node.js 18+ or Bun (because we're fancy like that) 🥖
• Git (hopefully you know what this is) 📝
• Convex account (free tier = best tier) 🆓
• API keys (the keys to the AI kingdom) 🔑

# Grab the code (it's open source, so it's yours now!)
git clone https://github.com/xwedx00/x00chat.git
cd X00Chat

# Install dependencies with Bun (because it's blazingly fast™)
bun install

x00chat runs on Convex - think Firebase, but for people who actually read the docs.

# Login to Convex (first time? It'll create an account!)
bunx convex login

# Initialize your digital empire
bunx convex dev --once

This magical incantation will:

• Spawn a new Convex project in your dashboard 📊
• Generate schema files (the blueprint of your data) 📋
• Create .env.local with deployment URLs (guard this with your life) 🔐

⚠️ WARNING: Don't nuke your .env.local file! Convex already populated it with the good stuff.

# Check what you need (it's like a shopping list, but for APIs)
cat .env.example

# Manually add these to your existing .env.local:
# - AI API keys (OpenAI, Google, Anthropic, etc.)
# - Analytics keys (PostHog, Umami)
# - Search provider keys (Exa)
# - Other configuration magic ✨

# Initialize the auth system
bunx @convex-dev/auth

# Set up Google OAuth (follow the guide, it's actually good!)
bunx convex env set AUTH_GOOGLE_ID your-super-secret-google-id
bunx convex env set AUTH_GOOGLE_SECRET your-even-more-secret-google-secret

# Generate encryption keys (this is where the magic happens)
bunx convex env set API_KEY_SECRET $(openssl rand -hex 64)

# Set your local development URL
bunx convex env set SITE_URL http://localhost:3000

Because storing files shouldn't require a PhD in cloud architecture:

1. Create Your Storage Empire:

   • Sign up for Cloudflare
   • Navigate to R2 (it's like S3, but cooler)
   • Create a bucket with a name that sparks joy
   • Make it public (trust me on this one)
   • Configure CORS (copy-paste from the docs)

2. Get Your Secret Keys:

   bunx convex env set R2_BUCKET your-awesome-bucket-name
   bunx convex env set R2_TOKEN your-r2-api-token
   bunx convex env set R2_ACCESS_KEY_ID your-access-key
   bunx convex env set R2_SECRET_ACCESS_KEY your-secret-sauce
   bunx convex env set R2_ENDPOINT https://your-account.r2.cloudflarestorage.com
   bunx convex env set R2_PUBLIC_URL_BASE https://your-bucket.your-domain.com/

# For when you want to monetize your genius
bunx convex env set POLAR_ORGANIZATION_TOKEN your-polar-token
bunx convex env set POLAR_PREMIUM_PRODUCT_ID your-product-id
bunx convex env set POLAR_WEBHOOK_SECRET your-webhook-secret

# Deploy to the cloud! 🚀
bunx convex deploy

# Or for development with hot-reload magic
bunx convex dev

# Start your engines!
bun dev

Navigate to http://localhost:3000 and witness your creation! 🎉

# Deploy Convex to production
bunx convex deploy --prod

# Deploy frontend (Vercel is your friend)
bun add -g vercel
vercel --prod

Don't forget to update your production environment variables!

Convex Acting Up?

• Double-check you're logged in: bunx convex login
• Verify your deployment URLs in .env.local
• Try turning it off and on again: bunx convex dev

Authentication Blues?

• Check OAuth credentials in Convex dashboard
• Make sure SITE_URL matches your current URL
• Sometimes OAuth just needs a hug (restart everything)

API Keys Misbehaving?

• Verify keys are correctly set and have proper permissions
• Check if you've hit rate limits (it happens to the best of us)

File Upload Fails?

• Ensure R2 bucket is public and CORS is configured
• Check that R2_PUBLIC_URL_BASE ends with a trailing slash
• Verify all R2 environment variables are set in Convex

We welcome contributions like a server welcomes uptime! Fork it, fix it, feature it, and send us a PR.

• Write code like someone will have to debug it at 3 AM (because they will)
• Test on mobile (your users aren't all on 4K monitors)
• Document like your memory will be wiped tomorrow
• Keep it accessible (not everyone can see your beautiful color choices)

• Stream resuming with Redis (because persistence is key)
• Performance optimizations (faster is always better)
• More AI model integrations (gotta catch 'em all)
• Bug hunting (they're everywhere!)

Current Status: Beta Release - Like early access, but for productivity tools 🎮

Compatibility: This version is a significant evolution from earlier releases. Think of it as x00chat 2.0, but we're too humble to call it that.

Performance: Built for scale and optimized for humans who actually want to get stuff done 📈

Privacy: Your data, your rules. We just provide the tools 🛡️

This code started as work by Julien Thibeaut (Apache License 2.0) but has been heavily modified, improved, and enhanced by xwedx00 throughout 2025. It's like Ship of Theseus, but for code. 🚢

P.S. If you made it this far, you deserve a cookie 🍪 (and probably a raise for reading documentation this thoroughly).