Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/kernferm/bubbles-ai-gpt

A secure, web-based chat interface that lets you talk to multiple AI models from different providers - all in one beautiful, easy-to-use application.
https://github.com/kernferm/bubbles-ai-gpt

ai ai-assistants chat-application chatgpt claude gemini gpt multi-ai personal

Last synced: 4 months ago
JSON representation

A secure, web-based chat interface that lets you talk to multiple AI models from different providers - all in one beautiful, easy-to-use application.

Awesome Lists containing this project

README 

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



A secure, web-based chat interface that lets you talk to multiple AI models from different providers - all in one beautiful, easy-to-use application.



## 🌟 What This Application Does



**Bubbles-AI-GPT** is your personal AI assistant hub that gives you access to the world's most popular AI models through a single, clean chat interface. Think of it as having ChatGPT, Claude, Gemini, and many other AI assistants all in one place!



## Running the Executable



1. **Keep all files together.** Don’t move `server.exe` out of the folder.

2. Double-click `server.exe`.



### ✨ 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



## 🚀 Quick Start Guide



### Step 1: Start the Server

1. Navigate to this folder: `bubbles-ai-gpt-main`

2. Run: `server.exe`

3. Your browser will automatically open to `http://localhost:8000`



### Step 2: Sign In or Create Account

- **New users**: Click "Create Account" to make a free Puter account

- **Existing users**: Click "Sign In" with your Puter credentials

- **Required**: You must be signed in to access AI chat features



### Step 3: Choose Your AI

- **For beginners**: Keep "Puter.js" selected - it works immediately!

- **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.11+** 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 `server.exe`)

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.*



## 📥 How to Download the Repo (First-Time Users)



Click the link to read [**Instructions**](https://www.gitprojects.fnbubbles420.org/how-to-download-repos) 📄.



### Download ZIP:

1. 📥 Click the green `"Code"` button at the top right of the repository page.

2. 📂 Choose `"Download ZIP"` from the dropdown menu.

3. 📁 This will download a `ZIP file` with the entire repository.

### Extract the ZIP File:

1. 🗂 Find the downloaded `ZIP file` on your computer.

2. 🔧 `Extract` it using your computer's built-in extraction tool or a third-party tool like `WinRAR` or `7-Zip`.