{"id":14971513,"url":"https://github.com/MAHMOUDELSAYED7/Qubic-AI","last_synced_at":"2025-10-26T16:30:41.113Z","repository":{"id":254580117,"uuid":"846442139","full_name":"MAHMOUDELSAYED7/Qubic-AI","owner":"MAHMOUDELSAYED7","description":"Qubic AI is an intelligent chatbot powered by Google Generative AI Gemini, featuring a user-friendly interface, efficient state management with Bloc, and local chat history storage with Hive.","archived":false,"fork":false,"pushed_at":"2025-02-07T22:16:28.000Z","size":781,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T23:21:11.570Z","etag":null,"topics":["bloc","chatbot","cubit","cubit-bloc","db","dependency-injection","flutter","flutter-android","flutter-apps","flutter-bloc","flutter-hive","flutter-screenutil","gemini","google-gemini","google-generative-ai","hive","hivedb","local-database","mvvm-architecture","stream-data"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MAHMOUDELSAYED7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-23T08:07:49.000Z","updated_at":"2025-02-07T22:16:31.000Z","dependencies_parsed_at":"2024-08-24T14:27:52.505Z","dependency_job_id":"6c899ae3-031b-4b0d-b96b-0174033269c9","html_url":"https://github.com/MAHMOUDELSAYED7/Qubic-AI","commit_stats":{"total_commits":44,"total_committers":2,"mean_commits":22.0,"dds":"0.045454545454545414","last_synced_commit":"bb130a97c59362e4b376efb84b93209344628de3"},"previous_names":["mahmoudelsayed69/qubic-ai","mahmoudelsayed7/qubic-ai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MAHMOUDELSAYED7%2FQubic-AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MAHMOUDELSAYED7%2FQubic-AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MAHMOUDELSAYED7%2FQubic-AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MAHMOUDELSAYED7%2FQubic-AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MAHMOUDELSAYED7","download_url":"https://codeload.github.com/MAHMOUDELSAYED7/Qubic-AI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238366670,"owners_count":19460167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bloc","chatbot","cubit","cubit-bloc","db","dependency-injection","flutter","flutter-android","flutter-apps","flutter-bloc","flutter-hive","flutter-screenutil","gemini","google-gemini","google-generative-ai","hive","hivedb","local-database","mvvm-architecture","stream-data"],"created_at":"2024-09-24T13:45:18.683Z","updated_at":"2025-10-26T16:30:40.663Z","avatar_url":"https://github.com/MAHMOUDELSAYED7.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv style=\"display: flex; align-items: center;\"\u003e\n \u003cimg src=\"https://github.com/user-attachments/assets/7a182490-7e90-4083-930e-62d1f45c66d4\" alt=\"Qubic AI\" style=\"width: 10%; margin-right: 20px;\"\u003e\n  \u003ch1\u003eQubic AI\u003c/h1\u003e\n\u003c/div\u003e\n\n**Qubic AI** is your intelligent conversational partner, seamlessly blending the power of [**Google Generative AI Gemini**](https://developers.generativeai.google/) with the elegance of Flutter. Whether you're seeking instant answers or engaging in deep, insightful dialogues, Qubic AI is designed to be your go-to AI assistant. The app delivers a smooth, intuitive chat interface, powered by Bloc for efficient state management, and a comprehensive history feature, backed by Hive for secure, local storage—allowing you to revisit and manage your past conversations effortlessly.\n## ✨ Features\n\n- **`Conversational AI`:** Powered by Google Generative AI Gemini, providing accurate and context-aware responses.\n- **`Chat Interface`:** Modern, user-friendly chat screen for seamless interaction with the AI bot.\n- **`History Management`:** Effortlessly access and manage your past conversations, stored locally using Hive DB.\n- **`State-of-the-Art Architecture`:** Built with Bloc for scalable, efficient state management, and structured with the **`MVVM`** (Model-View-ViewModel) architecture for maintainable and testable code.\n\n## 📱 Screenshots\n\u003cdiv style=\"display: flex; justify-content: space-between;\"\u003e\n \n  \u003cimg src=\"https://github.com/user-attachments/assets/66df802c-4500-44c7-8a35-5047da9db25b\" alt=\"Screenshot 1\" style=\"width: 24%;\"/\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/893a3a3b-0a88-4a44-8eba-0ebce4bb8503\" alt=\"Screenshot 2\" style=\"width: 24%;\"/\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/99432f04-3e82-4f72-b9b1-314df3d19e35\" alt=\"Screenshot 3\" style=\"width: 24%;\"/\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/8df971c4-a349-45b4-af49-5d45806fa7ae\" alt=\"Screenshot 4\" style=\"width: 24%;\"/\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/981aa5c3-5c81-4858-a7cc-98e51aeba3ef\" alt=\"Screenshot 6\" style=\"width: 24%;\"/\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/f56ab606-5658-45b7-af06-f3339b44e425\" alt=\"Screenshot 7\" style=\"width: 24%;\"/\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/9c463e01-4ac6-40d7-8dd7-deb480270194\" alt=\"Screenshot 8\" style=\"width: 24%;\"/\u003e\n\n\n\u003c/div\u003e\n \n## 🚀 Getting Started\n\nTo get started with Qubic AI, follow these steps:\n\n- **`Step 1:`** Clone the Repository\nFirst, you'll need to clone the repository from GitHub. Open your terminal and run the following command:\n```\nhttps://github.com/MAHMOUDELSAYED7/Qubic-AI.git\n```\nReplace \u003crepository-url\u003e with the actual URL of your repository if it was changed.\n\n- **`Step 2:`** Install Dependencies\nAfter navigating to the project directory, you need to install all the necessary dependencies. Run:\n```\nflutter pub get\n```\nThis command fetches all the dependencies listed in the `pubspec.yaml` file.\n\n- **`Step 3:`** Configure the App\nEnsure all necessary configurations are done. This includes adding your assets and setting up environment variables if needed. Verify that your `pubspec.yaml` file includes all required `assets`.\n\n- **`Step 4:`** Run the Application\nFinally, run the application on your desired device using the following command:\n`\n```\nflutter run\n```\nThis command compiles your Flutter app and deploys it to the connected device or simulator.\n\nAdditional Tips\n**`Updating Dependencies:`** If there are any updates to the dependencies, you can update them using:\n```\nflutter pub upgrade --major-versions\n```\nFlutter Doctor: Run flutter doctor to ensure that your development environment is set up correctly.\n```\nflutter doctor\n```\nThis command checks your environment and displays a report of the status of your Flutter installation, dependencies, and connected devices.\n\nBy following these steps, you'll have the Qubic AI app and running on your device. If you encounter any issues during installation, please refer to the Flutter documentation.\n\n## 🛠 Dependencies\n- **`bloc`**: Business logic component to manage state efficiently.\n- **`flutter_bloc`**: Bloc integration with Flutter, simplifying UI binding.\n- **`google_generative_ai`**: Interface with Google Generative AI Gemini for powerful AI-driven responses.\n- **`hive`**: Lightweight and fast key-value database for Flutter.\n- **`hive_flutter`**: Adapter for Hive, integrating seamlessly with Flutter.\n- **`flutter_dotenv`**: Manage environment variables using a .env file.\n- **`flutter_screenutil`**: Screen adaptation for responsive design across devices.\n- **`formatted_text`**: Rich text formatting package.\n- **`get_it`**: Dependency injection and service locator for easy app configuration.\n- **`intl`**: Internationalization support.\n- **`loading_indicator`**: Visually appealing loading animations.\n#### Dev Dependencies\n- **`build_runner`**: Code generation tool for Flutter and Dart.\n- **`hive_generator`**: Hive Type Adapter generator for custom data types.\n- **`flutter_launcher_icons`**: Easily generate app icons for Android and iOS.\n- **`flutter_lints`**: Linting rules for maintaining high code quality.\n\n## 🚀 Usage\n1. **`Launching the App`**\n- Open Qubic AI on your device to start interacting with the AI.\n2. **`Starting a Conversation`**\n- On the Chat Screen, type your question or message in the input field at the bottom.\n- Press the send button to initiate the conversation with Qubic AI.\n- The AI will respond with context-aware answers powered by Google Generative AI Gemini.\n3. **`Creating a New Chat`**\n- To start a new conversation, tap the \"Create New Chat\" button located next to the input field.\n- This will clear the current chat and allow you to engage with the AI afresh.\n4. **`Accessing Chat History`**\n- Navigate to the History Screen by selecting the history icon from the menu.\n- View a list of all your past conversations, stored locally using Hive DB.\nYou can:\n- Continue a Conversation: Tap on any previous chat to resume the discussion with the AI.\n- Delete a Chat: Swipe left on any chat entry to delete it from your history if you no longer need it.\n\n#### Enjoy using Note Studio to keep your notes organized and easily accessible!\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## ✉️ Contact\n\nFor any questions or feedback, please reach out via email: [mahmoudelsayed.dev@gmail.com](mahmoudelsayed.dev@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMAHMOUDELSAYED7%2FQubic-AI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMAHMOUDELSAYED7%2FQubic-AI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMAHMOUDELSAYED7%2FQubic-AI/lists"}