Skip to content

A Flutter-based chat application featuring a space-themed UI that integrates with the Gemini Pro AI, offering an immersive conversation experience with cosmic aesthetics and robust functionality.

License

Notifications You must be signed in to change notification settings

TribeMedia/Space-GPT

 
 

Repository files navigation

Space GPT

A sophisticated Flutter-based chat application featuring a space-themed UI that integrates with the Gemini Pro language model.

🚀 Features

  • Space-themed user interface with custom animations
  • Real-time chat integration with Gemini Pro AI
  • Customizable user and bot avatars
  • Cross-platform support (Android, iOS, Windows, macOS, Linux)
  • High-performance image caching and preloading
  • Message grouping and timestamps
  • Dark mode optimized design
  • Typing indicators
  • Scroll-to-bottom functionality
  • Message copy and formatting support

🛠 Tech Stack

  • Flutter/Dart (SDK ^3.5.3)
  • BLoC Pattern for state management (bloc, flutter_bloc)
  • Dio for HTTP requests
  • Lottie for animations (^3.1.3)
  • Google's Gemini Pro API
  • Custom image caching system
  • Cupertino Icons (^1.0.8)

📁 Project Structure

lib/
├── bloc/
│   ├── chat_bloc.dart                 
│   ├── chat_event.dart
│   └── chat_state.dart              
├── utils/
│   └── constants.dart                  
├── repos/
│   └── chat_repo.dart  
├── model/
│   └── chat_messgae_model.dart                              
├── models/
│   └── profile_model.dart                  
├── pages/
│   └── home_page.dart
├── screens/
│   └── profile_selector_screen.dart               
└── main.dart                     

🚦 Getting Started

Prerequisites

  • Flutter SDK (latest stable version)
  • Dart SDK
  • Android Studio/VS Code with Flutter plugins
  • Gemini Pro API key

Installation

  1. Clone the repository:
git clone https://github.com/WWI2196/Space-GPT.git
cd space_gpt
  1. Install dependencies:
flutter pub get
  1. Configure API key in constants.dart:
const String apiKey = 'YOUR_API_KEY_HERE';
  1. Run the application:
flutter run

⚙️ Configuration

Theme Customization

theme: ThemeData(
  fontFamily: "Space Mono",
  brightness: Brightness.dark,
  scaffoldBackgroundColor: Colors.grey.shade900,
  primaryColor: Colors.pink.shade900,
)

Avatar Profiles

Add custom avatars in:

  • user_profiles
  • bot_profiles

🔧 Development Resources

⚡ Performance Optimizations

  • Image preloading and caching
  • Optimized message rendering with RepaintBoundary
  • Efficient message grouping
  • Virtual scrolling implementation

🤝 Contributing

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

📄 License

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

About

A Flutter-based chat application featuring a space-themed UI that integrates with the Gemini Pro AI, offering an immersive conversation experience with cosmic aesthetics and robust functionality.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dart 51.1%
  • C++ 29.5%
  • CMake 16.2%
  • HTML 1.9%
  • C 1.1%
  • Kotlin 0.2%