🤖 Bubbles-AI-GPT: Multi-AI Chat Application

A secure, web-based chat interface for talking to multiple AI models from different providers—all in one beautiful, easy-to-use application.

📝 How to Use & Run

1. Install Python

• Download and install Python 3.11 or newer from python.org.
• Important: During installation, check the box that says "Add Python to PATH". This ensures you can run Python from the command line.

2. Start the Server

• Open a terminal or command prompt.
• Navigate to the project folder containing server.py and index.html:
  • Example: cd path/to/bubbles-ai-gpt/bubbles-ai-gpt
• Run the server:
  • python server.py
• The server will start and your browser should open to http://localhost:8000 automatically.

3. Access the Web Interface

• Open index.html in your browser, or let the server open it for you.
• Sign in or create a Puter account to access AI chat features.

4. Chat with AI

• Type your message and press Enter or click the arrow button.
• Choose your preferred AI provider and model.

---

🌟 What’s New

• Logout Flow Improved: After logging out, you’ll see a pop-up asking if you want to exit and close the app or stay on the login screen.
• Exit Button: Cleanly shuts down the server from the browser when you choose to exit.
• Frontend/Backend Integration: The app now allows the browser to request the backend server to shut down for a seamless exit experience.

🚀 Quick Start Guide

1. Start the Server

   • Open your terminal/command prompt.
   • Navigate to this folder: cd path/to/bubbles-ai-gpt
   • Run: python server.py
   • Your browser will automatically open to http://localhost:8000

2. Sign In or Create Account

   • New users: Click "Create Account" for a free Puter account.
   • Existing users: Click "Sign In" with your Puter credentials.
   • Required: You must be signed in to access AI chat features.

3. Choose Your AI

   • Beginners: Keep "Puter.js" selected—it works immediately!
   • Advanced: Click "⚙️ Configure" to add your own API keys.

4. Start Chatting!

   • Type your message and press Enter or click the arrow button.
   • Watch the AI respond in real-time!

5. Logout and Exit

   • Click the logout button to sign out.
   • After logout, choose to exit (which shuts down the server and closes the app) or stay on the login screen.

✨ Key Features

• 🔄 Multiple AI Providers: Switch between different AI services instantly

  • Puter.js (Default - No API key needed!)
  • OpenAI (ChatGPT models)
  • Anthropic (Claude models)
  • Google (Gemini models)
  • Groq (Fast, free models)
  • Hugging Face (Open-source models)

• 🎯 Smart Model Selection: Choose from dozens of AI models

  • GPT-4o, GPT-3.5 Turbo
  • Claude 3.5 Sonnet, Opus, Haiku
  • Gemini Pro, Gemini 1.5 Flash
  • Llama 3, Mixtral, and more!

• 🔒 Privacy & Security: Your conversations stay private

  • Runs locally on your computer
  • Secure Puter.js authentication required
  • No data sent to third parties (except to chosen AI providers)
  • Secure HTTPS connections only

• 💬 Beautiful Chat Interface

  • Clean, modern design
  • Chat bubbles like your favorite messaging apps
  • Real-time status updates
  • Mobile-friendly responsive design

• For advanced users: Click "⚙️ Configure" to add your own API keys

Step 4: Start Chatting!

• Type your message in the text box
• Press Enter or click the arrow button
• Watch the AI respond in real-time!

🎮 How to Use Different AI Providers

� Authentication Required

Important: You must sign in with a Puter account to use any AI features in this application. This ensures secure access to AI services and protects your conversations.

• New to Puter? Click "Create Account" for a free account
• Existing user? Click "Sign In" with your credentials
• Why required? Puter provides secure authentication and AI access management

�🟢 Puter.js (Recommended for Beginners)

• Requires Puter account! Sign in or create a free account first
• Access to GPT, Claude, Gemini, and open-source models
• Seamless integration with your Puter cloud account

🔑 Other Providers (Advanced Users)

1. First: Make sure you're signed in to your Puter account
2. Click the "API Provider" dropdown
3. Select your preferred provider (OpenAI, Claude, etc.)
4. Click "⚙️ Configure"
5. Add your API key (links provided for getting keys)
6. Start chatting with that provider's models!

💡 What Can You Do With This App?

📝 Writing & Content

• Write essays, stories, or blog posts
• Get help with emails and letters
• Create social media content
• Proofread and edit text

🤔 Learning & Research

• Ask questions about any topic
• Get explanations of complex concepts
• Help with homework or projects
• Learn new skills step-by-step

💻 Programming Help

• Debug code and fix errors
• Learn programming languages
• Get code examples and explanations
• Review and optimize your code

🎨 Creative Projects

• Brainstorm ideas for projects
• Create characters and stories
• Write poetry and lyrics
• Generate creative prompts

🧠 Problem Solving

• Work through complex problems
• Get different perspectives on decisions
• Plan projects and organize tasks
• Analyze data and information

🛡️ Security Features

Your safety and privacy are our top priorities:

• 🔐 Puter.js Authentication: Secure login required to access AI features
• 🔐 Encrypted Connections: All AI communications use HTTPS
• 🚫 No Local Data Storage: Conversations aren't saved on the local server
• ⚡ Rate Limiting: Prevents abuse and keeps the service stable
• 🛡️ Path Protection: Blocks malicious file access attempts
• 🔍 Request Validation: All inputs are sanitized for security

🆓 Cost Information

Free Options

• Puter.js: Free tier available with generous limits
• Groq: Completely free with fast models (Llama 3, Mixtral)
• Hugging Face: Free access to open-source models

Paid Options

• OpenAI: Pay-per-use (typically $0.002-0.06 per 1K tokens)
• Anthropic: Pay-per-use (similar to OpenAI pricing)
• Google: Generous free tier, then pay-per-use

🔧 Technical Requirements

• Python 3.6+ installed on your computer
• Web browser (Chrome, Firefox, Safari, Edge)
• Internet connection for AI API access
• Puter account (free) for authentication and AI access
• Optional: API keys for advanced providers

🆘 Troubleshooting

"Can't access the app"

• Make sure you're signed in to your Puter account
• Click "Sign In" or "Create Account" if you see the login screen
• Check your internet connection for Puter authentication

"Server won't start"

• Make sure Python is installed: python --version
• Check if port 8000 is available
• Run from the correct folder (where server.py is located)

"AI not responding"

• Ensure you're signed in to your Puter account first
• Check your internet connection
• Try switching to a different model
• For API key providers, verify your key is correct

"403 Forbidden errors"

• This is normal for some models/providers
• Try switching to Puter.js or a different model
• Check if your API key has sufficient credits

🤝 Getting Help

If you need assistance:

1. Check the error messages in the browser console (F12)
2. Try switching AI providers or models
3. Restart the server (Ctrl+C then python server.py)
4. Ensure your API keys are correctly configured

🎉 Have Fun!

Bubbles-AI-GPT is designed to make AI accessible and enjoyable for everyone. Whether you're a student, professional, creator, or just curious about AI, this app gives you the power to chat with the world's most advanced AI models from the comfort of your own computer.

Happy chatting! 🚀

---

Built with ❤️ for the AI community. Secure, private, and powerful.