SoulChat AI is a high-performance, full-stack AI companion solu on featuring a scalable CodeIgniter 4
backend and a stunning Flu er UI. This market-ready pla orm supports English, Sinhala, and Tamil chat
interac ons and operates on a virtual coin economy integrated with a viral referral engine. Key highlights
include mul media chat support (character-sent images and videos), a custom AI character creator, and
high-fidelity image genera on powered by Stability AI. It is the ul mate turnkey solu on for launching a
localized or global AI roleplay, companion, or virtual assistant service with persistent chat history and top
er security.

Included Components
● Application: Full Flutter Source Code (Dart).
● REST API: Comprehensive PHP Source Code (CodeIgniter 4).
● Database: MySQL Schema with predefined character data. 

1. Secure Authentication

●       Google Quick Sign-In: One-tap integration via Firebase for seamless onboarding.

●       Manual Registration: Email and password-based login.

●       SMTP OTP Verification: Secure email verification using high-delivery OTP services.

●       Secure Session Management: Token-based API security.

2. AI Character Discovery

●       Personality Directory: Browse a catalog of AI characters with unique backstories and traits.

●       Video Previews: Immersive video introductions for characters to enhance the user experience.

●       Category Filtering: Discover characters based on specific archetypes or interests.

3. Advanced AI Chat Engine

●       Multi-Model Integration: Powered by Google Gemini and Venice AI for human-like, intelligent responses.

●       Real-Time Streaming: Messages stream in real-time, providing a dynamic chat feel.

●       Persistent Chat History: Seamlessly sync and save conversations across sessions.

●       Contextual Awareness: The AI remembers character traits and previous interaction details.

4. Viral Referral & Coin Economy

●       Referral System: Users can invite friends via unique codes to grow the platform organically.

●       Coin Rewards: Instant coin credits for successful referrals.

●       Virtual Wallet: Built-in transaction history and coin balance management.

●       Usage Metering: Consume coins to unlock premium character interactions.

5. AI Media Generation

●       Stability AI Integration: High-quality Text-to-Image generation for creating custom characters or assets.

●       Private User Gallery: A dedicated space for users to view and manage their AI-generated images.

For Mobile Applica on (Flutter)
● Flu er SDK: 3.10.0 or higher.
● Android Studio / VS Code: Latest stable version.
● Minimum SDK Version: 21 (Android 5.0).
● Java JDK: 17 or higher.
● Firebase Project: Required for Google Sign-In and Remote Config.
For Backend & Database
● PHP Environment: 8.1+ (XAMPP/MAMP or Linux Server).
● Framework: CodeIgniter 4.
● Database: MySQL 8.0+.
● Composer: For managing PHP dependencies.
● API Keys Required: Google Gemini, Stability AI, Venice AI. 

Please refer to the document uploaded with the main file for instructions