https://github.com/techcow2/island-ai
Island AI is a free, modern ChatGPT alternative featuring smart multimodal chat, integrated web search, a polished interface, and a unique Questioning Mode that asks clarifying questions before delivering precise, real-time responses.
https://github.com/techcow2/island-ai
artificial-intelligence assistant-chat-bots chatbot chatgpt gemini multimodal pollinations-ai react tailwindcss typescript
Last synced: 2 months ago
JSON representation
Island AI is a free, modern ChatGPT alternative featuring smart multimodal chat, integrated web search, a polished interface, and a unique Questioning Mode that asks clarifying questions before delivering precise, real-time responses.
- Host: GitHub
- URL: https://github.com/techcow2/island-ai
- Owner: techcow2
- License: mit
- Created: 2025-08-05T02:17:00.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2025-08-06T05:11:26.000Z (2 months ago)
- Last Synced: 2025-08-06T07:08:55.909Z (2 months ago)
- Topics: artificial-intelligence, assistant-chat-bots, chatbot, chatgpt, gemini, multimodal, pollinations-ai, react, tailwindcss, typescript
- Language: TypeScript
- Homepage: https://islandapps.dev/chat
- Size: 500 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 🏝️ Island AI – Free ChatGPT Alternative with Questioning Mode
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](https://vitejs.dev/)
[](https://tailwindcss.com/)
[](https://php.net/)
Island AI is a modern, no-cost ChatGPT substitute that delivers smart, multi-model conversations, integrated web search, and a polished user interface. Its standout Questioning Mode invites the AI to ask you 3–5 clarifying questions before answering, ensuring each response is sharply focused on your exact needs. Built with React and TypeScript, Island AI offers a smooth chat experience featuring authentication, chat persistence, and real-time streaming responses—all in one elegant package.
## 🌐 Try It Now
**🚀 [Access the hosted version at islandai.app](https://islandai.app)**
No installation required! Try Island AI instantly in your browser with full features including multiple AI models, web search, and questioning mode.
## 🌟 Features
- **Multiple AI Models**: Support for various AI models including GPT-4, Gemini, and Pollinations
- **Real-time Streaming**: Live streaming responses for immediate feedback
- **Web Search Integration**: Enhanced responses with real-time web search capabilities
- **User Authentication**: Firebase-based authentication system
- **Chat Persistence**: Save and manage conversation history
- **Mobile Responsive**: Optimized for all device sizes
- **Modern UI/UX**: Beautiful interface with Framer Motion animations
- **Voice Support**: Text-to-speech capabilities
- **Markdown Support**: Rich text rendering with syntax highlighting
- **Rate Limiting**: Built-in request throttling for optimal performance
- **PWA Ready**: Progressive Web App capabilities
## 🏗️ Architecture
### Frontend (React + TypeScript)
- **Framework**: React 19.1.0 with TypeScript
- **Build Tool**: Vite 5.4.11
- **Styling**: TailwindCSS 4.1.11 with custom components
- **State Management**: React hooks and context
- **Animations**: Framer Motion for smooth interactions
- **Authentication**: Firebase Auth
- **Storage**: Firebase Firestore for chat persistence
### Backend (PHP)
- **API Proxy**: PHP-based proxy servers for AI model APIs
- **Endpoints**: Gemini API proxy, streaming support, and web search
- **CORS Handling**: Proper cross-origin request management
## 📋 Prerequisites
- **Node.js** (v18 or higher)
- **PHP** (v7.4 or higher)
- **npm** or **yarn**
- **Gemini API Key** (from Google AI Studio)
- **LangSearch API Key** (optional, for enhanced web search)
## 🚀 Quick Start
### 1. Clone the Repository
```bash
git clone https://github.com/techcow2/Island.git
```
### 2. Install Dependencies
```bash
# Install frontend dependencies
npm install
# Install PHP dependencies (if using Composer)
composer install
```
### 3. Environment Setup
```bash
# Copy environment file
cp .env.example .env
# Edit .env file with your API keys
# Required:
# GEMINI_API_KEY=your_gemini_api_key_here
# Optional:
# LANGSEARCH_API_KEY=your_langsearch_api_key_here
```
### 4. Get API Keys
#### Gemini API Key (Required)
1. Visit [Google AI Studio](https://makersuite.google.com/app/apikey)
2. Create a new API key
3. Add it to your `.env` file
#### LangSearch API Key (Optional)
1. Visit [LangSearch Dashboard](https://langsearch.com/dashboard)
2. Create an account and get your API key
3. Add it to your `.env` file for enhanced web search
### 5. Start Development Servers
#### Frontend Development Server
```bash
npm run dev
```
This starts the Vite development server on `http://localhost:3000`
#### Backend PHP Server
```bash
# Start PHP built-in server for API endpoints
php -S localhost:8000 -t .
```
### 6. Access the Application
Open your browser and navigate to `http://localhost:3000`
## 📁 Project Structure
```
island/
├── src/ # Frontend source code
│ ├── components/ # React components
│ │ ├── ui/ # Reusable UI components
│ │ ├── AuthModal.tsx # Authentication modal
│ │ ├── SettingsPanel.tsx # Settings configuration
│ │ ├── MobileMenu.tsx # Mobile navigation
│ │ └── ... # Other components
│ ├── services/ # API and utility services
│ │ ├── gemini.ts # Gemini API integration
│ │ ├── pollinations.ts # Pollinations API
│ │ ├── auth.ts # Firebase authentication
│ │ ├── chatStorage.ts # Chat persistence
│ │ └── ... # Other services
│ ├── hooks/ # Custom React hooks
│ ├── utils/ # Utility functions
│ ├── App.tsx # Main application component
│ └── main.tsx # Application entry point
├── api/ # PHP backend APIs
│ ├── gemini-proxy.php # Gemini API proxy
│ ├── gemini-stream.php # Streaming responses
│ └── langsearch-proxy.php # Web search proxy
├── public/ # Static assets
│ └── images/ # Icons and images
├── dist/ # Build output
├── package.json # Frontend dependencies
├── composer.json # PHP dependencies
├── vite.config.js # Vite configuration
├── tailwind.config.js # TailwindCSS configuration
├── .env.example # Environment template
└── README.md # This file
```
## 🛠️ Available Scripts
```bash
# Development
npm run dev # Start development server
npm run build # Build for production
npm run preview # Preview production build
npm run lint # Run ESLint
# PHP Server
php -S localhost:8000 -t . # Start PHP development server
```
## ⚙️ Configuration
### Environment Variables
| Variable | Description | Required |
|----------|-------------|---------|
| `GEMINI_API_KEY` | Google Gemini API key | Yes |
| `LANGSEARCH_API_KEY` | LangSearch API key for web search | No |
| `FRONTEND_URL` | Frontend URL for CORS (default: http://localhost:3000) | No |
### Model Configuration
The application supports multiple AI models:
- **GPT-4**: Via Pollinations service
- **Gemini**: Google's Gemini Pro model
- **Claude**: Via Pollinations service
- **Other models**: Extensible architecture for additional models
### Features Configuration
Users can configure:
- **Model Selection**: Choose preferred AI model
- **Web Search**: Enable/disable web search integration
- **Voice Settings**: Configure text-to-speech options
- **Questioning Mode**: Enhanced follow-up question generation
## 🔧 Development
### Adding New AI Models
1. Create a new service in `src/services/`
2. Implement the required interface
3. Add model configuration to the settings panel
4. Update the main App component to handle the new model
### Customizing UI Components
The project uses a modular component architecture:
- Base components in `src/components/`
- Reusable UI components in `src/components/ui/`
- Styled with TailwindCSS and custom CSS
### API Proxy Development
PHP proxies handle:
- CORS headers
- API key management
- Request/response transformation
- Error handling
## 📱 Mobile Support
Island AI is fully responsive and includes:
- Mobile-optimized interface
- Touch-friendly interactions
- Progressive Web App (PWA) capabilities
- Adaptive layouts for all screen sizes
## 🔒 Security
- API keys are stored server-side
- CORS properly configured
- Rate limiting implemented
- Input sanitization
- Secure authentication via Firebase
## 🚀 Deployment
### Production Build
```bash
# Build the application
npm run build
# The dist/ directory contains the production build
```
### Deployment Options
1. **Static Hosting**: Deploy `dist/` to any static host (Netlify, Vercel, etc.)
2. **Full Stack**: Deploy both frontend and PHP backend
3. **CDN**: Use with content delivery networks for global performance
### Environment Setup for Production
1. Set production environment variables
2. Configure proper CORS origins
3. Set up SSL certificates
4. Configure rate limiting
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
## 🙏 Acknowledgments
- [Google Gemini](https://ai.google.dev/) for AI capabilities
- [Pollinations](https://pollinations.ai/) for additional AI models
- [Firebase](https://firebase.google.com/) for authentication and storage
- [Tailwind CSS](https://tailwindcss.com/) for styling
- [Framer Motion](https://www.framer.com/motion/) for animations
- [React](https://reactjs.org/) and [Vite](https://vitejs.dev/) for the development experience
## 📞 Support
For support, please open an issue on GitHub or contact the development team.
---
**IslandApps.dev** - Making AI conversations accessible to everyone. 🏝️✨