Skip to content

Subrata0Ghosh/chativio

Repository files navigation

💬 Chativio

Chativio Logo

Chativio Logo Flutter Dart License: MIT Stars

Your AI Friend, Always Here 💙 Powered by Flutter & OpenAI GPT-4o-mini

📱 Download APK🌐 Live Demo📖 Documentation


✨ Features


Natural Conversations
Chat like with a real friend using advanced AI

Works Offline
Cached responses for seamless offline experience

Speak & Listen
Voice input and TTS responses

Smart Scheduling
Auto-detect and remind about events

Photo Chats
Send images and get AI descriptions

Beautiful Themes
Material 3 with animations & gradients

🎯 Key Highlights

  • 🧠 AI-Powered: GPT-4o-mini for intelligent responses
  • Fast & Smooth: Optimized animations and caching
  • 🔒 Privacy-First: All data stored locally
  • 🎨 Stunning UI: Gradient bubbles, slide-in effects, Material 3
  • 📱 Cross-Platform: Android, iOS, Web support

📱 Screenshots

Splash Screen Chat Interface Events Screen
Splash Chat Events

Screenshots of the app in action


🛠️ Tech Stack

Component Technology
Framework Flutter
Language Dart
AI OpenAI
Storage Hive
State Provider
Voice Speech

▶️ Getting Started

Prerequisites

  • Flutter
  • Android Studio or VS Code
  • OpenAI API Key (free tier available)

🚀 Quick Setup

  1. Clone & Setup 📥

    git clone https://github.com/Subrata0Ghosh/chativio.git
    cd chativio
    flutter pub get
  2. Add API Key 🔑

    # Create lib/secrets.dart
    echo "const String openAIApiKey = 'your-api-key-here';" > lib/secrets.dart
  3. Run App ▶️

    flutter run

📦 Build for Production

Platform Command
Android APK flutter build apk --release
iOS flutter build ios --release
Web flutter build web --release

📂 Project Structure

lib/
├── main.dart                 # 🚀 App Entry Point
├── providers/
│   └── theme_provider.dart   # 🎨 Theme Management
├── screens/
│   ├── chat_screen.dart      # 💬 Main Chat UI
│   ├── events_screen.dart    # 📅 Events Management
│   ├── stories_screen.dart   # 📖 Stories Reader
│   ├── flash_screen.dart     # ✨ Splash Screen
│   └── profile_screen.dart   # 👤 Settings & Profile
├── services/
│   ├── notification_service.dart # 🔔 Notifications
│   └── nlp_service.dart      # 🧠 NLP for Events
└── widgets/
    └── typing_dots.dart      # ⌨️ Typing Animation

🤝 Contributing

We love contributions! 🎉

Contributing Guide Issues PRs Welcome

  1. 🍴 Fork the repo
  2. 🌿 Create feature branch: git checkout -b feature/amazing-feature
  3. 💻 Commit changes: git commit -m 'Add amazing feature'
  4. 🚀 Push: git push origin feature/amazing-feature
  5. 🔄 Open Pull Request

📄 License

MIT License

This project is licensed under the MIT License See LICENSE file for details


🙏 Acknowledgments

Built with ❤️ by Subrata Ghosh

Special thanks to:

  • OpenAI for GPT models 🤖
  • Flutter community for amazing framework 🚀
  • Material Design for beautiful UI guidelines 🎨

🌟 Show some love!

GitHub stars GitHub forks

Made with Flutter & Love 💙