|
| 1 | +# DeepSeek Flutter Clone 🤖💬 |
| 2 | + |
| 3 | +<div align="center"> |
| 4 | + <img src="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/logo.svg?raw=true" width="60%" alt="DeepSeek-R1" /> |
| 5 | +</div> |
| 6 | + |
| 7 | +[](https://flutter.dev) |
| 8 | +[](https://dart.dev) |
| 9 | +[](https://opensource.org/licenses/MIT) |
| 10 | + |
| 11 | +A Flutter-based intelligent chat application replicating DeepSeek's core features, integrating advanced large language model (LLM) capabilities with cross-platform support. |
| 12 | + |
| 13 | +<p align="center"> |
| 14 | + <img src="screenshots/demo.jpg" width="300" alt="Demo Preview"> |
| 15 | +</p> |
| 16 | + |
| 17 | +## ✨ Key Features |
| 18 | + |
| 19 | +- **Intelligent Chat Interaction** |
| 20 | + - Continuous conversation context management |
| 21 | + - Real-time streaming responses |
| 22 | + - Message history preservation |
| 23 | + - Markdown rendering |
| 24 | + - Copy chat content |
| 25 | + |
| 26 | +- **User-Friendly Interface** |
| 27 | + - Adaptive light/dark themes (TODO) |
| 28 | + - Responsive layout design |
| 29 | + - Interactive animations |
| 30 | + - Conversation session management |
| 31 | + - Multi-language support (i18n) |
| 32 | + |
| 33 | +- **Advanced Capabilities** |
| 34 | + - Custom API endpoint configuration |
| 35 | + - Token usage statistics (TODO) |
| 36 | + - Chat content search (TODO) |
| 37 | + - System prompt templates (TODO) |
| 38 | + - Network status monitoring (TODO) |
| 39 | + |
| 40 | +## 🚀 Quick Start |
| 41 | + |
| 42 | +### Requirements |
| 43 | +- Flutter 3.29+ |
| 44 | +- Dart 3.7+ |
| 45 | +- Android Studio/VSCode |
| 46 | +- iOS/Android simulator or physical device |
| 47 | + |
| 48 | +### Installation |
| 49 | +```bash |
| 50 | +# Clone repository |
| 51 | +git clone https://github.com/luodeb/deepseek-flutter-clone.git |
| 52 | + |
| 53 | +# Enter project directory |
| 54 | +cd deepseek-flutter-clone |
| 55 | + |
| 56 | +# Install dependencies |
| 57 | +flutter pub get |
| 58 | + |
| 59 | +# Run application |
| 60 | +flutter run |
| 61 | +``` |
| 62 | + |
| 63 | +## ⚙️ Configuration |
| 64 | + |
| 65 | +1. Create `api_config.dart` in `lib/configs` directory |
| 66 | +2. Add your API configuration: |
| 67 | +```dart |
| 68 | +const String apiKey = 'YOUR_API_KEY'; |
| 69 | +const String baseUrl = 'YOUR_API_ENDPOINT'; |
| 70 | +``` |
| 71 | + |
| 72 | +## 📸 Screenshots |
| 73 | + |
| 74 | +| Chat Interface | History | Settings | |
| 75 | +|----------|----------|----------| |
| 76 | +| <img src="screenshots/main.jpg" width="300"> | <img src="screenshots/drawer.jpg" width="300"> | <img src="screenshots/settings.jpg" width="300"> | |
| 77 | + |
| 78 | +## 📁 Project Structure |
| 79 | + |
| 80 | +``` |
| 81 | +├── app |
| 82 | +│ ├── middleware |
| 83 | +│ ├── modules |
| 84 | +│ │ ├── dashboard |
| 85 | +│ │ │ ├── bindings |
| 86 | +│ │ │ ├── controllers |
| 87 | +│ │ │ └── views |
| 88 | +│ │ ├── language |
| 89 | +│ │ │ ├── bindings |
| 90 | +│ │ │ ├── controllers |
| 91 | +│ │ │ └── views |
| 92 | +│ │ └── settings |
| 93 | +│ │ ├── bindings |
| 94 | +│ │ ├── children |
| 95 | +│ │ │ ├── dark_mode |
| 96 | +│ │ │ │ ├── bindings |
| 97 | +│ │ │ │ ├── controllers |
| 98 | +│ │ │ │ └── views |
| 99 | +│ │ │ ├── model |
| 100 | +│ │ │ │ ├── bindings |
| 101 | +│ │ │ │ ├── controllers |
| 102 | +│ │ │ │ └── views |
| 103 | +│ │ │ └── others |
| 104 | +│ │ ├── controllers |
| 105 | +│ │ └── views |
| 106 | +│ └── routes |
| 107 | +├── configs |
| 108 | +│ ├── localization |
| 109 | +│ │ ├── ar_AR |
| 110 | +│ │ ├── en_US |
| 111 | +│ │ └── zh_CN |
| 112 | +│ └── theme |
| 113 | +├── models |
| 114 | +├── utils |
| 115 | +└── widgets |
| 116 | +``` |
| 117 | + |
| 118 | +## 🤝 Contributing |
| 119 | + |
| 120 | +1. Fork the project |
| 121 | +2. Create feature branch (`git checkout -b feature/AmazingFeature`) |
| 122 | +3. Commit changes (`git commit -m 'Add some AmazingFeature'`) |
| 123 | +4. Push branch (`git push origin feature/AmazingFeature`) |
| 124 | +5. Open Pull Request |
| 125 | + |
| 126 | +## 📄 License |
| 127 | + |
| 128 | +Distributed under [MIT License](LICENSE) |
| 129 | + |
| 130 | +--- |
| 131 | + |
| 132 | +**Note**: Ensure proper API access authorization before use. This application requires integration with LLM APIs. |
| 133 | + |
0 commit comments