{"id":29884225,"url":"https://github.com/kernferm/bubbles-ai-gpt","last_synced_at":"2026-02-08T00:34:17.191Z","repository":{"id":302691419,"uuid":"1013243367","full_name":"KernFerm/Bubbles-AI-GPT","owner":"KernFerm","description":"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.","archived":false,"fork":false,"pushed_at":"2025-12-01T20:38:32.000Z","size":25004,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-04T00:57:45.380Z","etag":null,"topics":["ai","ai-assistants","chat-application","chatgpt","claude","gemini","gpt","multi-ai","personal"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KernFerm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":[{"name":"Cash App","url":"https://cash.app/$BubblesTheDev"}]}},"created_at":"2025-07-03T15:21:11.000Z","updated_at":"2025-12-01T20:38:36.000Z","dependencies_parsed_at":"2025-07-03T18:51:29.869Z","dependency_job_id":"02a99371-fd20-4264-beba-d9e0a1fb5d43","html_url":"https://github.com/KernFerm/Bubbles-AI-GPT","commit_stats":null,"previous_names":["kernferm/bubbles-ai-gpt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KernFerm/Bubbles-AI-GPT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-AI-GPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-AI-GPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-AI-GPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-AI-GPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KernFerm","download_url":"https://codeload.github.com/KernFerm/Bubbles-AI-GPT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FBubbles-AI-GPT/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29214394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-08T00:10:47.190Z","status":"ssl_error","status_checked_at":"2026-02-08T00:10:43.589Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-assistants","chat-application","chatgpt","claude","gemini","gpt","multi-ai","personal"],"created_at":"2025-07-31T14:44:31.971Z","updated_at":"2026-02-08T00:34:17.160Z","avatar_url":"https://github.com/KernFerm.png","language":"HTML","funding_links":[{"name":"Cash App","url":"https://cash.app/$BubblesTheDev"}],"categories":[],"sub_categories":[],"readme":"# 🤖 Bubbles-AI-GPT: Multi-AI Chat Application\r\n\r\nA secure, web-based chat interface that lets you talk to multiple AI models from different providers - all in one beautiful, easy-to-use application.\r\n\r\n## 🌟 What This Application Does\r\n\r\n**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!\r\n\r\n## Running the Executable\r\n\r\n1. **Keep all files together.** Don’t move `server.exe` out of the folder.\r\n2. Double-click `server.exe`.\r\n\r\n### ✨ Key Features\r\n\r\n- **🔄 Multiple AI Providers**: Switch between different AI services instantly\r\n  - **Puter.js** (Default - No API key needed!)\r\n  - **OpenAI** (ChatGPT models)\r\n  - **Anthropic** (Claude models)\r\n  - **Google** (Gemini models)\r\n  - **Groq** (Fast, free models)\r\n  - **Hugging Face** (Open-source models)\r\n\r\n- **🎯 Smart Model Selection**: Choose from dozens of AI models\r\n  - GPT-4o, GPT-3.5 Turbo\r\n  - Claude 3.5 Sonnet, Opus, Haiku\r\n  - Gemini Pro, Gemini 1.5 Flash\r\n  - Llama 3, Mixtral, and more!\r\n\r\n- **🔒 Privacy \u0026 Security**: Your conversations stay private\r\n  - Runs locally on your computer\r\n  - Secure Puter.js authentication required\r\n  - No data sent to third parties (except to chosen AI providers)\r\n  - Secure HTTPS connections only\r\n\r\n- **💬 Beautiful Chat Interface**\r\n  - Clean, modern design\r\n  - Chat bubbles like your favorite messaging apps\r\n  - Real-time status updates\r\n  - Mobile-friendly responsive design\r\n\r\n## 🚀 Quick Start Guide\r\n\r\n### Step 1: Start the Server\r\n1. Navigate to this folder: `bubbles-ai-gpt-main`\r\n2. Run: `server.exe`\r\n3. Your browser will automatically open to `http://localhost:8000`\r\n\r\n\r\n### Step 2: Sign In or Create Account\r\n- **New users**: Click \"Create Account\" to make a free Puter account\r\n- **Existing users**: Click \"Sign In\" with your Puter credentials\r\n- **Required**: You must be signed in to access AI chat features\r\n\r\n### Step 3: Choose Your AI\r\n- **For beginners**: Keep \"Puter.js\" selected - it works immediately!\r\n- **For advanced users**: Click \"⚙️ Configure\" to add your own API keys\r\n\r\n### Step 4: Start Chatting!\r\n- Type your message in the text box\r\n- Press Enter or click the arrow button\r\n- Watch the AI respond in real-time!\r\n\r\n## 🎮 How to Use Different AI Providers\r\n\r\n###   Authentication Required\r\n**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.\r\n\r\n- **New to Puter?** Click \"Create Account\" for a free account\r\n- **Existing user?** Click \"Sign In\" with your credentials\r\n- **Why required?** Puter provides secure authentication and AI access management\r\n\r\n###  🟢 Puter.js (Recommended for Beginners)\r\n- **Requires Puter account!** Sign in or create a free account first\r\n- Access to GPT, Claude, Gemini, and open-source models\r\n- Seamless integration with your Puter cloud account\r\n\r\n### 🔑 Other Providers (Advanced Users)\r\n1. **First**: Make sure you're signed in to your Puter account\r\n2. Click the \"API Provider\" dropdown\r\n3. Select your preferred provider (OpenAI, Claude, etc.)\r\n4. Click \"⚙️ Configure\"\r\n5. Add your API key (links provided for getting keys)\r\n6. Start chatting with that provider's models!\r\n\r\n## 💡 What Can You Do With This App?\r\n\r\n### 📝 **Writing \u0026 Content**\r\n- Write essays, stories, or blog posts\r\n- Get help with emails and letters\r\n- Create social media content\r\n- Proofread and edit text\r\n\r\n### 🤔 **Learning \u0026 Research**\r\n- Ask questions about any topic\r\n- Get explanations of complex concepts\r\n- Help with homework or projects\r\n- Learn new skills step-by-step\r\n\r\n### 💻 **Programming Help**\r\n- Debug code and fix errors\r\n- Learn programming languages\r\n- Get code examples and explanations\r\n- Review and optimize your code\r\n\r\n### 🎨 **Creative Projects**\r\n- Brainstorm ideas for projects\r\n- Create characters and stories\r\n- Write poetry and lyrics\r\n- Generate creative prompts\r\n\r\n### 🧠 **Problem Solving**\r\n- Work through complex problems\r\n- Get different perspectives on decisions\r\n- Plan projects and organize tasks\r\n- Analyze data and information\r\n\r\n## 🛡️ Security Features\r\n\r\nYour safety and privacy are our top priorities:\r\n\r\n- **🔐 Puter.js Authentication**: Secure login required to access AI features\r\n- **🔐 Encrypted Connections**: All AI communications use HTTPS\r\n- **🚫 No Local Data Storage**: Conversations aren't saved on the local server\r\n- **⚡ Rate Limiting**: Prevents abuse and keeps the service stable\r\n- **🛡️ Path Protection**: Blocks malicious file access attempts\r\n- **🔍 Request Validation**: All inputs are sanitized for security\r\n\r\n## 🆓 Cost Information\r\n\r\n### Free Options\r\n- **Puter.js**: Free tier available with generous limits\r\n- **Groq**: Completely free with fast models (Llama 3, Mixtral)\r\n- **Hugging Face**: Free access to open-source models\r\n\r\n### Paid Options\r\n- **OpenAI**: Pay-per-use (typically $0.002-0.06 per 1K tokens)\r\n- **Anthropic**: Pay-per-use (similar to OpenAI pricing)\r\n- **Google**: Generous free tier, then pay-per-use\r\n\r\n## 🔧 Technical Requirements\r\n\r\n- **Python 3.11+** installed on your computer\r\n- **Web browser** (Chrome, Firefox, Safari, Edge)\r\n- **Internet connection** for AI API access\r\n- **Puter account** (free) for authentication and AI access\r\n- **Optional**: API keys for advanced providers\r\n\r\n## 🆘 Troubleshooting\r\n\r\n### \"Can't access the app\"\r\n- Make sure you're signed in to your Puter account\r\n- Click \"Sign In\" or \"Create Account\" if you see the login screen\r\n- Check your internet connection for Puter authentication\r\n\r\n### \"Server won't start\"\r\n- Make sure Python is installed: `python --version`\r\n- Check if port 8000 is available\r\n- Run from the correct folder (where server.py is located)\r\n\r\n### \"AI not responding\"\r\n- Ensure you're signed in to your Puter account first\r\n- Check your internet connection\r\n- Try switching to a different model\r\n- For API key providers, verify your key is correct\r\n\r\n### \"403 Forbidden errors\"\r\n- This is normal for some models/providers\r\n- Try switching to Puter.js or a different model\r\n- Check if your API key has sufficient credits\r\n\r\n## 🤝 Getting Help\r\n\r\nIf you need assistance:\r\n1. Check the error messages in the browser console (F12)\r\n2. Try switching AI providers or models\r\n3. Restart the server (`Ctrl+C` then `server.exe`)\r\n4. Ensure your API keys are correctly configured\r\n\r\n## 🎉 Have Fun!\r\n\r\nBubbles-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.\r\n\r\n**Happy chatting! 🚀**\r\n\r\n---\r\n\r\n*Built with ❤️ for the AI community. Secure, private, and powerful.*\r\n\r\n## 📥 How to Download the Repo (First-Time Users)\r\n\r\nClick the link to read [**Instructions**](https://www.gitprojects.fnbubbles420.org/how-to-download-repos) 📄.\r\n\r\n### Download ZIP:\r\n1. 📥 Click the green `\"Code\"` button at the top right of the repository page.\r\n2. 📂 Choose `\"Download ZIP\"` from the dropdown menu.\r\n3. 📁 This will download a `ZIP file` with the entire repository.\r\n### Extract the ZIP File:\r\n1. 🗂 Find the downloaded `ZIP file` on your computer.\r\n2. 🔧 `Extract` it using your computer's built-in extraction tool or a third-party tool like `WinRAR` or `7-Zip`.\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fbubbles-ai-gpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkernferm%2Fbubbles-ai-gpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fbubbles-ai-gpt/lists"}