Metadata-Version: 2.4
Name: jarvis-neural-interface
Version: 8.0.2
Summary: A futuristic ChatGPT-style AI assistant with neural interface
Home-page: https://github.com/ParthDesai2012/Ai_asisstant
Author: AI Assistant
Author-email: jarvis@neural.interface
Project-URL: Bug Reports, https://github.com/ParthDesai2012/Ai_asisstant/issues
Project-URL: Source, https://github.com/ParthDesai2012/Ai_asisstant
Keywords: ai assistant jarvis neural interface chatbot voice automation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tkinter
Requires-Dist: requests
Requires-Dist: keyboard
Requires-Dist: pyttsx3
Requires-Dist: psutil
Provides-Extra: voice
Requires-Dist: speechrecognition; extra == "voice"
Requires-Dist: pyaudio; extra == "voice"
Provides-Extra: full
Requires-Dist: speechrecognition; extra == "full"
Requires-Dist: pyaudio; extra == "full"
Requires-Dist: ollama; extra == "full"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# JARVIS Neural Interface v8.0

A futuristic ChatGPT-style AI assistant with advanced holographic UI, powered by local Ollama Llama3 model.

## 🚀 Features

### ChatGPT-Style Interface
- **Message Bubbles**: Clean chat interface with "You:" and "JARVIS:" labels
- **Scrollable Chat History**: Maintains conversation context with timestamps
- **Real-time Responses**: Instant message display with voice synthesis
- **Message Management**: Clear chat functionality

### Futuristic UI Enhancements
- **Neural Network Visualization**: Animated data nodes and connection lines at the top
- **Particle System**: Subtle floating particles for ambient effect
- **Holographic Effects**: Gradient backgrounds and glowing elements
- **Smooth Animations**: 50ms refresh rate for fluid motion
- **Transparent Overlay**: Always-on-top interface with adjustable opacity

### Advanced AI Capabilities
- **Local AI Processing**: Uses Ollama Llama3 for privacy-focused AI interactions
- **Contextual Responses**: AI maintains conversation history
- **Error Handling**: Graceful fallbacks for network and system issues
- **Multi-threaded**: Non-blocking operations for smooth UI

### Enhanced Commands
- **System Integration**: Chrome, Opera GX, YouTube, GitHub, Notepad, Calculator, CMD, Explorer
- **Power Management**: Shutdown, restart, sleep mode controls with safety delays
- **System Monitoring**: Real-time CPU/memory usage with `system:status`
- **Mathematical Calculations**: Built-in calculator with `calc:<expression>`
- **Time & Date**: Current system time and date information

### Voice & Interaction
- **Text-to-Speech**: Natural voice synthesis with adjustable parameters
- **Voice Commands Ready**: Framework for voice input (requires additional libraries)
- **Hotkey Controls**: Keyboard shortcuts for all major functions
- **Drag Interface**: Move the window by dragging anywhere

## 🎮 Controls

### Hotkeys
- `Ctrl + Space` - Toggle JARVIS interface visibility
- `Ctrl + Shift + C` - Clear chat history
- `Ctrl + Shift + Q` - Emergency shutdown

### Interface Controls
- **🚀 SEND** - Send your message
- **🗑️ CLEAR** - Clear all chat messages
- **Drag** - Click and drag to move the interface
- **Enter** - Send message from input field

## 💻 Commands

### System Commands
```
run:chrome          - Open Chrome browser
run:opera           - Open Opera GX browser
run:youtube         - Open YouTube
run:github          - Open GitHub
run:notepad         - Open Notepad
run:calculator      - Open Calculator
run:cmd             - Open Command Prompt
run:explorer        - Open File Explorer
run:shutdown        - Shutdown computer (30s delay)
run:restart         - Restart computer (30s delay)
run:sleep           - Put computer to sleep
run:time            - Show current time
run:date            - Show current date
run:system          - Show system information
```

### Special Commands
```
calc:<expression>   - Calculate mathematical expressions
system:status       - Show detailed system status
```

### AI Queries
Simply type any question or request for AI-powered responses with full conversation context.

## 🔧 Installation & Setup

### Prerequisites
- **Python 3.8+** - Download from [python.org](https://python.org)
- **Ollama** - Install from [ollama.ai](https://ollama.ai/)
- **Git** - For cloning and version control

### Quick Start
1. **Clone the repository:**
   ```bash
   git clone https://github.com/ParthDesai2012/Ai_asisstant.git
   cd Ai_asisstant
   ```

2. **Install dependencies:**
   ```bash
   pip install -r requirements.txt
   ```

3. **Setup Ollama:**
   ```bash
   ollama pull llama3
   ollama serve
   ```

4. **Run JARVIS:**
   ```bash
   python api.py
   ```

### Alternative Installation
```bash
pip install git+https://github.com/ParthDesai2012/Ai_asisstant.git
```

## 🎨 Customization

### Colors & Themes
- **Background**: Deep space gradient (#0a0a0a to #1a1a1a)
- **User Messages**: Green accent (#00ff88)
- **JARVIS Messages**: Blue accent (#0088ff)
- **Interface**: Cyan highlights (#00ffff)
- **Particles**: Dynamic brightness based on lifetime

### Performance Settings
- **Particle Count**: 30 particles for optimal performance
- **Animation Speed**: 50ms refresh rate
- **Voice Rate**: 180 words per minute (configurable)
- **Message History**: 50 messages maximum

### Advanced Configuration
- **Window Size**: 1000x700 pixels (customizable)
- **Transparency**: 95% opacity (adjustable)
- **Font**: Consolas monospace for futuristic look

## 🔮 Technical Architecture

### Core Components
- **Neural Interface**: Tkinter-based GUI with canvas animations
- **AI Engine**: Ollama Llama3 integration with local processing
- **Voice System**: Pyttsx3 text-to-speech engine
- **Command Processor**: Modular command system with threading
- **Particle Engine**: Custom animation system for visual effects

### Threading Model
- **Main Thread**: UI rendering and event handling
- **Worker Threads**: AI processing, voice synthesis, command execution
- **Animation Thread**: Continuous particle and neural network animations

### Error Handling
- **Network Failures**: Graceful degradation to offline mode
- **System Errors**: Comprehensive exception handling with user feedback
- **Resource Management**: Automatic cleanup and memory optimization

## 📊 System Requirements

### Minimum
- **OS**: Windows 10+
- **RAM**: 4GB
- **Storage**: 500MB
- **Python**: 3.8+

### Recommended
- **OS**: Windows 11
- **RAM**: 8GB+
- **Storage**: 1GB SSD
- **Python**: 3.11+

## 🐛 Troubleshooting

### Common Issues
- **"AI offline"**: Ensure Ollama is running (`ollama serve`)
- **No voice output**: Check system audio settings
- **Interface not responding**: Restart the application
- **High CPU usage**: Reduce particle count or animation speed

### Debug Mode
Run with verbose logging:
```bash
python api.py --debug
```

### Reset Configuration
Delete the config file and restart:
```bash
del %APPDATA%\jarvis\config.json
```

## 🚀 Future Enhancements

- [ ] Voice recognition integration
- [ ] Multi-language support
- [ ] Plugin system for custom commands
- [ ] Neural network training interface
- [ ] AR/VR integration
- [ ] Cross-platform support (Linux/Mac)
- [ ] Cloud synchronization
- [ ] Advanced AI model support

## 📝 Contributing

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

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- **Ollama** for local AI processing
- **Tkinter** for the GUI framework
- **Pyttsx3** for voice synthesis
- **Community** for inspiration and feedback

---

*Built with Python & Tkinter | Powered by Ollama Llama3 | Designed for the future of human-AI interaction*

**Ready to experience the future? Launch JARVIS and begin your neural journey!** 🤖✨</content>
<parameter name="filePath">c:\Users\theon\OneDrive\Desktop\ai_assistant\README.md
