Content
# Atlas AI - Intelligent Assistant Supporting Arabic Language
## 🚀 New Features
### 🔑 Enhanced API Key Management
- **Free Default Keys**: The application works directly with free default keys.
- **Custom Keys**: Users can enter their own keys.
- **Fallback System**: If the user does not enter a key, the default key is used.
- **Data Protection**: All keys are stored locally on the device.
### 🤖 Available Free Models
#### Groq Models (10 Models)
- **Llama 3.1 8B**: Fast and balanced for general use.
- **Llama 3.1 70B**: Advanced for complex applications.
- **Mixtral 8x7B**: Specialized in programming and analysis.
- **Gemma 2 9B**: Updated Google model.
- **Gemma 2 27B**: Advanced Google model.
- **Llama 3.1 8B Instant**: Very fast for instant responses.
- **Llama 3.1 70B Versatile**: Versatile model.
- **Llama 3.1 405B Reasoning**: Specialized in logical reasoning.
- **Llama 3.1 1B Instruct**: Small and fast for simple instructions.
- **Llama 3.1 3B Instruct**: Balanced for instructions and conversations.
#### GPTGod Models (17 Models)
- **GPT-3.5 Turbo**: Balanced for general use.
- **GPT-3.5 Turbo 16K**: With longer context.
- **GPT-4**: Advanced for complex applications.
- **GPT-4 Turbo**: The latest and fastest.
- **GPT-4 Turbo Preview**: Experimental with the latest features.
- **GPT-4 32K**: With very long context.
- **Claude 3 Opus**: The most advanced from Anthropic.
- **Claude 3 Sonnet**: Balanced from Anthropic.
- **Claude 3 Haiku**: Fast from Anthropic.
- **Gemini Pro**: Advanced from Google.
- **Gemini Pro Vision**: With image support.
- **Llama 2 7B/13B/70B Chat**: Meta's conversation models.
- **Code Llama 7B/13B/34B Instruct**: Specialized in programming.
### 🎯 Tooltip Feature for Models
- **Detailed Information**: Hovering over any model displays its information.
- **Features**: Speed, quality, context, special features.
- **Interactive Interface**: Custom dialog to display all models.
### 🔧 Core Features
- **Multi-Model Support**: Choose from 27 free models.
- **Training and Improving Models**: Ability to train models.
- **Advanced Web Search**: Using Tavily API.
- **Save and Export Conversations**: Manage conversations.
- **Multiple and Customizable Themes**: Full customization of appearance.
- **Data Protection and Privacy**: All data is stored locally.
## 📱 Installation and Usage
### Requirements
- Flutter 3.0+
- Dart 2.19+
- Android 5.0+ / iOS 11.0+
### Installation
```bash
git clone https://github.com/your-username/atlas-ai.git
cd atlas-ai
flutter pub get
flutter run
```
### Initial Setup
1. **Run the Application**: The application works directly with default keys.
2. **Enter Custom Keys** (Optional):
- Go to API settings.
- Enter your own keys.
- Or leave the fields empty to use the default keys.
3. **Select a Model**: Choose from the 27 available models.
4. **Start the Conversation**: Begin the conversation directly.
## 🎨 Technical Features
### API Key Management
```dart
// Get a key with fallback
final groqKey = await ApiKeyManager.getApiKey('groq');
// Check if using default keys
final isUsingDefault = await ApiKeyManager.isUsingDefaultKeys();
```
### Free Models
```dart
// Get the list of models
final groqModels = ApiKeyManager.getFreeModels('groq');
final gptgodModels = ApiKeyManager.getFreeModels('gptgod');
// Get information about a specific model
final modelInfo = ApiKeyManager.getModelInfo('groq', 'llama3-8b-8192');
```
### Tooltip for Models
```dart
Tooltip(
message: _buildModelTooltip(model),
child: Text(model['name']),
)
```
## 🔒 Security and Privacy
- **Local Encryption**: All keys are encrypted locally.
- **No Cloud Data**: All data is stored on the device.
- **Secure Default Keys**: Default keys are secure and free.
- **Data Protection**: No personal data is sent.
## 🚀 Performance
- **Lazy Initialization**: Services are initialized only when needed.
- **Memory Optimization**: Smart resource management.
- **Fast Response**: Quick and responsive interface.
- **Cross-Platform Support**: Works on Android, iOS, and Web.
## 📞 Support and Contribution
### Reporting Issues
- Email: <alromaihi2224@gmail.com>
- GitHub Issues: [Project Link]
### Contribution
We welcome all contributions! Please:
1. Fork the project.
2. Create a new branch.
3. Make your changes.
4. Submit a Pull Request.
## 📄 License
This project is licensed under the MIT License. See the LICENSE file for details.
## 👨💻 Developer
### Mohamed S AL-Romaihi
- Email: <alromaihi2224@gmail.com>
- GitHub: [GitHub Link]
---
**Atlas AI** - An intelligent assistant supporting the Arabic language with advanced model training capabilities 🚀
