A powerful AI image generation web application that works as a Telegram Mini App or standalone web app with Google OAuth authentication for premium features.

• 🔐 Multi-Platform Authentication - Telegram Mini App + Google OAuth support
• 🎨 AI Image Generation - Multiple models (Flux, DALL-E 3) with style options
• ✨ Prompt Enhancement - AI-powered prompt improvement
• 👤 User Management - Premium features and permission-based access
• 💎 Google Premium Access - Automatic premium features for Google users
• 🌙 Theme Support - Dark/Light modes that sync with Telegram
• 📱 Mobile Responsive - Optimized for mobile and desktop
• 🎯 Real-time Generation - Progress tracking and status updates

1. Telegram Bot Token - Get from @BotFather (for Telegram integration)
2. Google OAuth Credentials - Get from Google Cloud Console (for browser access)
3. Pollinations API Key - Get from Pollinations.ai
4. Python 3.8+ - For local development

1. Clone and navigate to webapp directory:

   cd webapp

2. Install dependencies:

   pip install -r requirements.txt

3. Configure environment:

   cp config.example.py config.py # Edit config.py with your API keys

4. Set environment variables:

   export BOT_TOKEN="your_telegram_bot_token" export POLLINATIONS_KEY="your_pollinations_api_key" export FLASK_SECRET_KEY="your_secure_secret_key"

5. Run the application:

   python app.py

# config.py # Telegram Integration (optional) BOT_TOKEN = "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghi" # Google OAuth (optional - for browser access) GOOGLE_CLIENT_ID = "your_google_client_id.apps.googleusercontent.com" GOOGLE_CLIENT_SECRET = "your_google_client_secret" # Required for all setups POLLINATIONS_KEY = "your_pollinations_api_key" FLASK_SECRET_KEY = "your-cryptographically-secure-secret-key" # Optional settings TELEGRAM_MINI_APP_REQUIRED = True SESSION_TIMEOUT = 24 * 60 * 60 # 24 hours MAX_IMAGES_PER_REQUEST = 4

1. Message @BotFather on Telegram
2. Send /newbot and follow instructions
3. Save your bot token securely

1. Send /setmenubutton to @BotFather
2. Select your bot
3. Provide your webapp URL (e.g., https://your-domain.com)
4. Set button text (e.g., "🎨 Generate Images")

/start - Start the bot /help - Get help information /settings - Open image generator 

1. Open your bot in Telegram
2. Tap the menu button or send /start
3. The webapp should open with authentication

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable the Google+ API or People API

1. Navigate to APIs & Services → Credentials
2. Click Create Credentials → OAuth 2.0 Client IDs
3. Choose Web application as application type
4. Add your domains to Authorized origins:

   https://yourdomain.com http://localhost:5000 (for development) 

5. Add callback URLs to Authorized redirect URIs:

   https://yourdomain.com/api/auth/google/callback http://localhost:5000/api/auth/google/callback 

export GOOGLE_CLIENT_ID="your_client_id.apps.googleusercontent.com" export GOOGLE_CLIENT_SECRET="your_client_secret"

1. Open your webapp directly in browser (not through Telegram)
2. You should see a "Login with Google" option
3. After login, users automatically get premium features

1. Fork this repository

2. Deploy to Vercel:

3. Set environment variables in Vercel dashboard:

   BOT_TOKEN=your_telegram_bot_token GOOGLE_CLIENT_ID=your_google_client_id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=your_google_client_secret POLLINATIONS_KEY=your_pollinations_api_key FLASK_SECRET_KEY=your_secure_secret_key 

4. Update bot settings in @BotFather with your Vercel URL

1. Create Heroku app:

   heroku create your-app-name

2. Set environment variables:

   heroku config:set BOT_TOKEN=your_telegram_bot_token heroku config:set GOOGLE_CLIENT_ID=your_google_client_id.apps.googleusercontent.com heroku config:set GOOGLE_CLIENT_SECRET=your_google_client_secret heroku config:set POLLINATIONS_KEY=your_pollinations_api_key heroku config:set FLASK_SECRET_KEY=your_secure_secret_key

3. Deploy:

   git subtree push --prefix webapp heroku main

1. Build Docker image:

   docker build -t advai-webapp .

2. Run container:

   docker run -p 5000:5000 \ -e BOT_TOKEN=your_telegram_bot_token \ -e GOOGLE_CLIENT_ID=your_google_client_id.apps.googleusercontent.com \ -e GOOGLE_CLIENT_SECRET=your_google_client_secret \ -e POLLINATIONS_KEY=your_pollinations_api_key \ -e FLASK_SECRET_KEY=your_secure_secret_key \ advai-webapp

Telegram Users:

1. Telegram Verification - Validates initData from Telegram WebApp
2. Hash Validation - Ensures data integrity using HMAC-SHA256

Google Users:

1. OAuth 2.0 Flow - Secure Google authentication
2. ID Token Validation - Verifies Google JWT tokens
3. Automatic Premium - Google users get premium features

All Users:

1. Session Management - Secure session handling with timeout
2. Permission System - Role-based access to features

• ✅ HTTPS required for production
• ✅ Secure session cookies
• ✅ CSRF protection via Telegram authentication
• ✅ Rate limiting on generation endpoints
• ✅ Input validation and sanitization

The app automatically adapts to Telegram's theme:

• 🌙 Dark Mode - For dark Telegram themes
• ☀️ Light Mode - For light Telegram themes

# Example permission system { 'can_generate_images': True, 'can_enhance_prompts': True, 'can_access_premium_models': user.is_premium, 'max_images_per_request': 4 if user.is_premium else 2 }

webapp/ ├── app.py # Main Flask application ├── telegram_auth.py # Telegram authentication module ├── config.py # Configuration file ├── requirements.txt # Python dependencies ├── static/ │ ├── css/style.css # Styles with Telegram theme support │ └── js/app.js # Frontend with Telegram WebApp integration ├── index.html # Main webpage └── vercel.json # Vercel deployment config 

1. Enable debug mode:

   export FLASK_DEBUG=True

2. Disable Telegram auth for testing:

   # config.py TELEGRAM_MINI_APP_REQUIRED = False

3. Run with auto-reload:

   python app.py

Q: Authentication fails with "No initialization data" A: Ensure the app is opened through Telegram, not directly in browser

Q: Images fail to generate A: Check your Pollinations API key and ensure it's valid

Q: Session expires quickly A: Increase SESSION_TIMEOUT in configuration

Q: Mini App doesn't open A: Verify your webapp URL is correct in @BotFather settings

Q: Google login button doesn't appear A: Check if GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET are configured

Q: Google authentication fails A: Ensure your domain is added to authorized origins in Google Cloud Console

Q: "Google authentication not available" error A: Install Google auth dependencies: pip install google-auth google-auth-oauthlib

Enable debug logging:

import logging logging.basicConfig(level=logging.DEBUG)

Use browser developer tools to check:

• Telegram WebApp object is available
• initData is being sent correctly
• Authentication API responses

This project is licensed under the MIT License - see the LICENSE file for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• 📧 Issues: GitHub Issues
• 💬 Telegram: @TechyCSR
• 🤖 Bot: @AdvChatGptBot