ai-helper-agent 2.0.1
Advanced AI-Powered Programming Assistant with Multi-Provider Support, Internet Search, and 40+ CLI Commands
License: MIT
Requires Python: >=3.8
Keywords: ai, assistant, programming, code-analysis, bug-fixing, automation, groq, openai, anthropic, google, langchain, internet-search, cli, developer-tools, ai-agent

# 🤖 AI Helper Agent v2.0.1

[![PyPI](https://img.shields.io/pypi/v/ai-helper-agent)](https://pypi.org/project/ai-helper-agent/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Development Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen)](https://pypi.org/project/ai-helper-agent/)

**Advanced AI-Powered Programming Assistant** with multi-provider support, internet search capabilities, and 40+ optimized CLI commands. Built for developers who want intelligent code assistance with blazing-fast performance.

## ⚡ **Performance Optimized**
- **🚀 Lightning Fast**: Optimized lazy loading reduces startup time by 99.97%
- **⚡ Sub-10ms**: CLI commands start in under 10 milliseconds
- **🎯 Production Ready**: Thoroughly tested with 100% feature compatibility

---

## � **Quick Start**

### **Installation**
```bash
pip install ai-helper-agent
```

### **Main Commands**
```bash
# Primary AI Chat Interface (Recommended)
ai-helper           # Enhanced multi-provider CLI with Rich UI

# Quick Access Commands  
ai-chat             # Start AI conversation
ai-assist           # AI assistance mode
ai-selector         # Interactive provider selection

# Specialized Interfaces
ai-groq             # Fast Groq-powered responses
ai-openai           # OpenAI GPT models
ai-anthropic        # Claude models
ai-google           # Google Gemini models

# Internet-Enabled
ai-web              # AI with web search capabilities
ai-search           # Internet-powered AI queries
ai-internet         # Web-enabled conversations
```

### **First Time Setup**
```bash
# Set your API key (choose one):
$env:GROQ_API_KEY="your_groq_api_key"         # Windows
export GROQ_API_KEY="your_groq_api_key"      # Linux/Mac

# Start chatting immediately
ai-helper
```

---

## 🌟 **Key Features**

### **🤖 Multi-Provider AI Support**
- ✅ **Groq**: Ultra-fast inference (1000+ tokens/sec)
- ✅ **OpenAI**: GPT-3.5, GPT-4, and latest models
- ✅ **Anthropic**: Claude models with advanced reasoning
- ✅ **Google**: Gemini Pro with multimodal capabilities
- ✅ **Ollama**: Local model support (coming soon)

### **🌐 Internet & Web Integration**
- ✅ **Smart Web Search**: DuckDuckGo and Google search integration
- ✅ **Real-time Information**: Access current data and latest updates
- ✅ **Web Content Processing**: Analyze and process web pages
- ✅ **Context-Aware Searches**: AI decides when to search the web

### **🎨 Rich Terminal Experience**
- ✅ **Beautiful UI**: Rich terminal formatting with tables and panels
- ✅ **Syntax Highlighting**: Code blocks with proper syntax highlighting
- ✅ **Streaming Responses**: Real-time response generation
- ✅ **Interactive Menus**: Easy provider and model selection

### **💾 Session Management**
- ✅ **Conversation History**: Persistent chat history across sessions
- ✅ **Session Export/Import**: Save and restore conversation states
- ✅ **Memory Management**: Context-aware conversation continuity
- ✅ **Multi-Session Support**: Separate conversations for different projects

### **� Security & Privacy**
- ✅ **Encrypted API Keys**: Secure local storage with encryption
- ✅ **No Data Collection**: All processing happens locally
- ✅ **Secure Communications**: HTTPS for all API communications
- ✅ **Key Management**: Easy and secure API key administration

---

## 📚 **Complete Command Reference**

### **Primary Interfaces**
| Command | Description | Best For |
|---------|-------------|----------|
| `ai-helper` | Enhanced multi-provider CLI | General use, rich features |
| `ai-chat` | Primary chat interface | Quick conversations |
| `ai-assist` | AI assistance mode | Code help and analysis |
| `ai-selector` | Interactive menu | Choosing providers visually |

### **Provider-Specific Commands**
| Command | Provider | Strengths |
|---------|----------|-----------|
| `ai-groq` | Groq | Ultra-fast responses |
| `ai-openai` | OpenAI | Most capable models |
| `ai-anthropic` | Anthropic | Code analysis & reasoning |
| `ai-google` | Google | Multimodal capabilities |
| `ai-ollama` | Ollama | Local/private models |

### **Internet-Enabled Commands**
| Command | Features | Use Cases |
|---------|----------|-----------|
| `ai-web` | Enhanced web CLI | Research with AI |
| `ai-search` | Internet search focus | Current information |
| `ai-internet` | Web-enabled chat | Latest developments |
| `ai-web-single` | Single provider + web | Fast web-enabled chat |

### **Multi-Provider Commands**
| Command | Description | Features |
|---------|-------------|----------|
| `ai-multi` | Full multi-provider | All providers available |
| `ai-providers` | Provider management | Switch between models |

### **Utility Commands**
| Command | Purpose | Usage |
|---------|---------|-------|
| `ai-setup` | API key configuration | Initial setup |
| `ai-config` | System configuration | Advanced settings |
| `ai-version` | Version information | Check current version |
| `ai-help` | Command help system | Get assistance |
| `ai-status` | System status | Check functionality |

### **Advanced Features**
| Command | Feature | Description |
|---------|---------|-------------|
| `ai-stream` | Streaming mode | Real-time responses |
| `ai-history` | View history | Browse past conversations |
| `ai-clear` | Clear history | Reset conversation memory |
| `ai-export` | Export conversations | Save chat history |
| `ai-import` | Import conversations | Restore chat history |

---

## � **Getting API Keys**

### **Free Options**
- **Groq**: Free tier with generous limits → [console.groq.com](https://console.groq.com/keys)

### **Premium Options**
- **OpenAI**: GPT-4 access → [platform.openai.com](https://platform.openai.com/api-keys)
- **Anthropic**: Claude models → [console.anthropic.com](https://console.anthropic.com/)
- **Google**: Gemini Pro → [makersuite.google.com](https://makersuite.google.com/app/apikey)

### **Setting API Keys**

**Windows (PowerShell):**
```powershell
$env:GROQ_API_KEY="your_api_key_here"
$env:OPENAI_API_KEY="your_openai_key"
$env:ANTHROPIC_API_KEY="your_anthropic_key"
$env:GOOGLE_API_KEY="your_google_key"
```

**Linux/Mac (Bash/Zsh):**
```bash
export GROQ_API_KEY="your_api_key_here"
export OPENAI_API_KEY="your_openai_key"
export ANTHROPIC_API_KEY="your_anthropic_key"
export GOOGLE_API_KEY="your_google_key"
```

---

## 💡 **Usage Examples**

### **Code Development**
```bash
ai-helper
> "Write a Python function to implement quicksort"
> "Explain this error: AttributeError: 'NoneType' object has no attribute 'split'"
> "Optimize this code for better performance"
> "Add error handling to this function"
```

### **Web Research & Current Information**
```bash
ai-web
> "What are the latest Python 3.12 features?"
> "Current best practices for React development in 2024"
> "Latest security vulnerabilities in Express.js"
> "Compare FastAPI vs Flask performance benchmarks"
```

### **Code Analysis & Review**
```bash
ai-anthropic
> "Review this code for potential security issues"
> "Suggest improvements for this algorithm"
> "Explain the time complexity of this function"
> "Generate unit tests for this class"
```

### **Multi-Modal Tasks**
```bash
ai-google
> "Analyze this image and generate corresponding code"
> "Convert this flowchart to Python implementation"
> "Explain this diagram in technical terms"
```

---

## 🛠 **Development & Advanced Usage**

### **Python API**
```python
from ai_helper_agent.core import AIHelperCore
from ai_helper_agent.providers import GroqProvider

# Initialize with specific provider
core = AIHelperCore()
provider = GroqProvider(api_key="your_key")

# Process requests
response = core.process_request(
    "Explain async/await in Python",
    provider=provider
)
print(response)
```

### **Configuration**
```python
from ai_helper_agent.core.config import config

# Customize settings
config.set_default_provider("groq")
config.set_streaming_enabled(True)
config.set_web_search_enabled(True)
```

### **Session Management**
```python
from ai_helper_agent.managers import ConversationManager

# Create named sessions
manager = ConversationManager()
session = manager.create_session("project_analysis")

# Resume sessions
session = manager.get_session("project_analysis")
```

---

## 🎨 **Rich UI Features**

The AI Helper Agent provides a beautiful terminal experience with:

- **� Tables**: Structured data presentation
- **🎨 Syntax Highlighting**: Code blocks with proper coloring
- **⚡ Progress Bars**: Real-time operation feedback
- **📋 Panels**: Organized information display
- **🎯 Interactive Menus**: Easy navigation and selection
- **💬 Streaming Text**: Real-time response generation

---

## 🔧 **System Requirements**

- **Python**: 3.8 or higher
- **Operating System**: Windows, Linux, macOS
- **Memory**: Minimum 512MB RAM
- **Storage**: 100MB free space
- **Network**: Internet connection for AI providers and web search

---

## 📖 **Documentation**

- **Quick Start**: Follow the examples above
- **API Reference**: Check docstrings in the code
- **Command Help**: Use `ai-help` for built-in assistance
- **GitHub Wiki**: Detailed guides and tutorials

---

## 🤝 **Contributing**

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

---

## 📄 **License**

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

## 🙋 **Support**

- **GitHub Issues**: [Report bugs or request features](https://github.com/AIMLDev726/ai-helper-agent/issues)
- **Email**: aistudentlearn4@gmail.com
- **Documentation**: Check built-in help with `ai-help`

---

## 🎯 **Why AI Helper Agent?**

- **⚡ Fast**: Optimized for speed with lazy loading
- **🔧 Flexible**: Multiple AI providers and models
- **🌐 Connected**: Internet search and web integration
- **🎨 Beautiful**: Rich terminal UI experience
- **🔒 Secure**: Encrypted API key storage
- **📱 Simple**: Easy-to-remember commands
- **🚀 Active**: Regular updates and improvements

**Start coding smarter with AI Helper Agent!** 🚀

# View existing keys (masked for security)
python -m ai_helper_agent.utilities.api_key_setup list

# Test API key connections
python -m ai_helper_agent.utilities.api_key_setup test

# Remove keys
python -m ai_helper_agent.utilities.api_key_setup remove groq

# Show help
python -m ai_helper_agent.utilities.api_key_setup --help
```

### **🆓 No API Key Required Options:**

- **G4F (GPT4Free)**: Use `ai-super-chat` for FREE GPT-4 access
- **Local Models**: Coming soon with Ollama integration

### **🔐 Security Features:**
- ✅ **Encrypted Storage**: All keys encrypted at rest
- ✅ **Local Storage**: Keys never leave your machine
- ✅ **Masked Display**: Keys shown as `gsk_***...***xyz`
- ✅ **Secure Prompts**: Password-style input for keys

---

## 📦 **Installation**

### **Simple Installation:**
```bash
pip install ai-helper-agent
```

### **Development Installation:**
```bash
git clone https://github.com/AIMLDev726/ai-helper-agent
cd ai-helper-agent
pip install -e .
```

---

## 🎯 **Features Overview**

### **🌟 Core Capabilities**
- ✅ **Multi-Provider AI**: Groq, OpenAI, Anthropic, Google AI, G4F
- ✅ **Free G4F Access**: No API keys needed for GPT-4
- ✅ **Internet Search**: Real-time web access and current information
- ✅ **File Processing**: Analyze, modify, and generate files
- ✅ **Browser Automation**: Web integration and automation tools
- ✅ **MCP Integration**: Model Context Protocol support
- ✅ **Code Generation**: Natural language to code conversion
- ✅ **Rich UI**: Beautiful terminal interfaces with tables and formatting
- ✅ **Session Memory**: Persistent conversation history
- ✅ **40+ Commands**: User-friendly CLI ecosystem

### **🔧 Advanced Features**
- 🎨 **Syntax Highlighting**: Beautiful code rendering with Rich UI
- 🔍 **Smart Search**: AI decides when to search the web
- 💾 **Session Management**: Named sessions for different projects
- ⚡ **Streaming Responses**: Real-time response generation
- 🛡️ **Security Controls**: Encrypted API key storage
- 📁 **Workspace Integration**: Context-aware file operations
- 🌐 **Browser Tools**: Web automation and scraping capabilities
- 🔗 **MCP Protocol**: Advanced context management
- 📊 **Rich Help System**: Beautiful help for all commands

### **🎨 User Experience**
- 🎯 **Easy Commands**: Non-technical names like `ai-super-chat`
- 📋 **Interactive Menu**: Visual CLI selector with `ai-menu`
- 🎨 **Rich UI**: Tables, colors, and beautiful formatting
- ⚡ **Quick Access**: Aliases like `ai-quick`, `ai-search`
- 🔧 **Developer Tools**: Advanced features with `ai-advanced`

---

## 🚀 **Quick Examples**

### **🌟 Flagship - Free AI with Internet**
```bash
ai-super-chat        # Start the flagship experience

# Example conversations:
> "What's the latest Python 3.12 features with examples?"
> "How to deploy FastAPI to AWS in 2024?"
> "Show me the newest React 18 hooks with code examples"
> "Debug this error: ModuleNotFoundError tensorflow"
> "Latest Django 5.0 tutorial with step-by-step guide"
```

### **⚡ Lightning Fast Responses**
```bash
ai-quick             # Ultra-fast Groq responses

# Perfect for:
> "Write a Python function to sort a list"
> "Explain this code: async def main():"
> "Convert this to TypeScript: const data = []"
> "Fix this syntax error in my function"
```

### **🌐 Web-Enabled Development**
```bash
ai-search            # Internet-powered development

# Ideal for:
> "Latest Django 5.0 tutorial with examples"
> "Current best practices for React 18 in 2024"
> "How to fix CORS errors in Express.js latest version"
> "Compare FastAPI vs Flask performance 2024"
```

### **🤖 Multi-Provider Power**
```bash
ai-multi             # Choose your AI provider

# Available providers:
# - Groq (Ultra-fast, 1000+ tokens/sec)
# - OpenAI (GPT-4, most capable)
# - Anthropic (Claude, great for code analysis)
# - Google (Gemini, multimodal capabilities)
# - G4F (Free GPT-4 access)
```

### **🔧 Developer Toolkit**
```bash
ai-dev               # Advanced development features

# Advanced capabilities:
> "Analyze all Python files in this project"
> "Review this code for security vulnerabilities"
> "Generate comprehensive unit tests for my functions"
> "Optimize the performance of this entire codebase"
> "Create documentation for this API"
```

### **🛠️ System Tools**
```bash
# Browser automation and web tools
ai-browser           # Web automation features

# MCP integration for advanced context
ai-mcp               # Model Context Protocol tools

# Core system functionality
ai-core              # Core system tools and utilities
```

---

## 📚 **Complete Command Reference**

### **🎯 Main Chat CLIs:**
| Command | Purpose | Features |
|---------|---------|----------|
| `ai-super-chat` | 🌟 Flagship (FREE G4F + Internet) | Free GPT-4, Web search, Rich UI |
| `ai-fast-chat` | ⚡ Ultra-fast (Groq only) | Lightning speed, 1000+ tokens/sec |
| `ai-web-chat` | 🌐 Internet-enabled (Groq + Web) | Smart web search, current info |
| `ai-smart-chat` | 🤖 Multi-provider | All AI providers, model selection |
| `ai-advanced` | 🔧 Developer toolkit | File processing, code analysis |
| `ai-menu` | 📋 Interactive selector | Visual CLI chooser |

### **🛠️ System & Utility Commands:**
| Command | Purpose | Features |
|---------|---------|----------|
| `ai-setup-keys` | 🔑 API key management | Interactive wizard, secure setup |
| `ai-browser` | 🌐 Browser automation | Web scraping, automation tools |
| `ai-mcp` | 🔗 MCP integration | Model Context Protocol |
| `ai-core` | ⚙️ Core system tools | System functionality |

### **⚡ Quick Access Aliases:**
| Alias | Main Command | Usage |
|-------|-------------|--------|
| `ai-quick` | `ai-fast-chat` | Ultra-fast responses |
| `ai-search` | `ai-web-chat` | Internet-powered queries |
| `ai-multi` | `ai-smart-chat` | Multi-provider access |
| `ai-dev` | `ai-advanced` | Developer features |
| `ai-keys` | `ai-setup-keys` | Key management |

---

## 🐍 **Python API Usage**

### **Basic Usage:**
```python
from ai_helper_agent import create_agent

# Create an agent instance
agent = create_agent()

# Ask for help
response = agent.process_request("How do I implement a binary search in Python?")
print(response)
```

### **Advanced Configuration:**
```python
from ai_helper_agent import InteractiveAgent
from ai_helper_agent.config import config

# Customize configuration
config.update({
    'temperature': 0.7,
    'max_tokens': 2048,
    'provider': 'groq',
    'model': 'llama-3.1-70b'
})

# Create agent with custom settings
agent = InteractiveAgent()
```

### **File Operations:**
```python
from ai_helper_agent import InteractiveAgent

agent = InteractiveAgent()

# Analyze a file
response = agent.process_request("Analyze the code in myfile.py")

# Get optimization suggestions  
response = agent.process_request("Optimize the performance of myfile.py")

# Generate unit tests
response = agent.process_request("Create unit tests for functions in mymodule.py")
```

### **Internet-Enabled Queries:**
```python
from ai_helper_agent import InternetAgent

# Create internet-enabled agent
agent = InternetAgent()

# Ask current questions
response = agent.process_request("What are the latest Python 3.12 features?")

# Technical documentation queries
response = agent.process_request("Show me FastAPI async database examples")
```

### **🎨 Rich Help System**
Every CLI has beautiful, comprehensive help:

```bash
ai-super-chat --help     # Flagship features and commands
ai-web-chat --help       # Internet search capabilities  
ai-advanced --help       # Developer toolkit overview
ai-smart-chat --help     # Multi-provider options
```

### **🔄 Session Management**
```bash
# Named sessions for different projects
ai-dev --session backend-api
ai-search --session frontend-bugs
ai-quick --session quick-scripts

# Quick mode (skip startup)
ai-super-chat --quick
ai-multi --quick
```

### **🌐 Internet Features**

#### **Permission Levels:**
- **Smart** (Default): AI decides when to search
- **Always**: Search for every query  
- **Ask**: Prompt before searching
- **Never**: Disable internet access

#### **Internet Commands (in chat):**
```bash
# Manual search
> internet search "latest React features"

# Change permissions  
> internet permission smart
> internet permission always
> internet permission ask
> internet permission never

# Check status
> internet
```

### **🤖 Provider-Specific Features**

#### **Groq (Ultra-Fast)**
- Models: Llama 3.1, Llama 3.3, Mixtral, Gemma
- Speed: ~1000 tokens/second
- Best for: Quick responses, coding tasks

#### **OpenAI (Most Capable)**  
- Models: GPT-4, GPT-4 Turbo, GPT-3.5 Turbo
- Best for: Complex reasoning, creative tasks

#### **Anthropic (Code Expert)**
- Models: Claude 3.5 Sonnet, Claude 3 Haiku  
- Best for: Code analysis, safety-focused tasks

#### **Google (Multimodal)**
- Models: Gemini Pro, Gemini 1.5 Pro
- Best for: Mixed content, vision tasks

#### **G4F (Free GPT-4)**
- Models: GPT-4, GPT-3.5, Various others
- Cost: 100% Free
- Best for: General use without API costs

---

## 🛠️ **Configuration & Setup**

### **Environment Variables**
```bash
# Optional: Set default provider
export AI_HELPER_DEFAULT_PROVIDER=groq

# Optional: Set default model
export AI_HELPER_DEFAULT_MODEL=llama-3.1-70b

# Optional: Custom workspace
export AI_HELPER_WORKSPACE=/path/to/project
```

### **Config File (Optional)**
Create `~/.ai-helper-agent/config.yaml`:
```yaml
default_provider: groq
default_model: llama-3.1-70b
temperature: 0.7
max_tokens: 4096
internet_permission: smart
session_persistence: true
```

---

## 🔐 **Security & Privacy**

### **API Key Security**
- ✅ **Encrypted Storage**: All keys encrypted at rest
- ✅ **Local Storage**: Keys never leave your machine
- ✅ **Masked Display**: Keys shown as `gsk_***...***xyz`
- ✅ **Secure Prompts**: Password-style input for keys

### **Internet Privacy**
- ✅ **User Control**: You control when internet is accessed
- ✅ **Transparent**: AI tells you when it searches
- ✅ **Configurable**: Set permission levels
- ✅ **No Tracking**: Searches are not logged or tracked

### **File Security**
- ✅ **Workspace Isolation**: Operations limited to workspace
- ✅ **Permission Checks**: Confirms before file modifications
- ✅ **Backup Options**: Can create backups before changes
- ✅ **Read-Only Mode**: Available for analysis-only tasks

---

## 🎯 **Use Cases & Examples**

### **🚀 Web Development**
```bash
ai-search

> "Create a Next.js 14 app with TypeScript and Tailwind"
> "How to implement authentication with NextAuth.js?"  
> "Debug CORS issues in my Express API"
> "Latest React 18 best practices for state management"
```

### **🐍 Python Development**
```bash
ai-dev

> "Analyze this Flask app for security vulnerabilities"
> "Generate FastAPI endpoints from this database schema"
> "Optimize this pandas data processing code"
> "Create unit tests for all functions in this file"
```

### **📱 Mobile Development**
```bash
ai-multi --provider anthropic

> "Convert this React component to React Native"
> "Create Flutter widgets for this design"
> "Implement SwiftUI navigation patterns"
> "Debug Android build.gradle dependencies"
```

### **🔬 Data Science**
```bash
ai-super-chat

> "What's the latest in machine learning frameworks?"
> "Create a PyTorch model for image classification"  
> "Analyze this dataset and suggest visualizations"
> "Compare TensorFlow vs PyTorch for NLP tasks"
```

### **☁️ DevOps & Deployment**
```bash
ai-expert

> "Create Docker setup for this Python app"
> "Generate Kubernetes deployment manifests"
> "Set up CI/CD pipeline for GitHub Actions"
> "Configure AWS Lambda deployment with Terraform"
```

---

## 🚨 **Troubleshooting**

### **Common Issues**

#### **"Command not found" Error**
```bash
# Reinstall to fix PATH issues
pip install --force-reinstall ai-helper-agent

# Or use Python module syntax
python -m ai_helper_agent.cli.cli_selector
```

#### **API Key Issues**
```bash
# Check if keys are set
python -m ai_helper_agent.utilities.api_key_setup list

# Test connections
python -m ai_helper_agent.utilities.api_key_setup test

# Re-add problematic keys
python -m ai_helper_agent.utilities.api_key_setup add groq
```

#### **Internet Search Not Working**
```bash
# Check internet permission
> internet

# Enable internet access
> internet permission smart

# Manual search test
> internet search "test query"
```

#### **Rich UI Display Issues**
```bash
# Update Rich library
pip install --upgrade rich

# Check terminal compatibility
python -c "from rich.console import Console; Console().print('✅ Rich working')"
```

---

## 🔄 **Version History**

### **v2.0.1 (Current) - August 2025**
- ✅ **User-Friendly Commands**: Easy-to-remember CLI names
- ✅ **Rich UI Help**: Beautiful help system for all CLIs
- ✅ **Fixed Coroutine Issues**: Resolved async/await problems
- ✅ **Enhanced Security**: Improved API key management
- ✅ **Command Aliases**: Multiple names for each CLI
- ✅ **Better Error Handling**: More helpful error messages

### **v1.0.0 - JUly 2024**
- 🌟 **G4F Integration**: Free GPT-4 access
- 🌐 **Internet Search**: Real-time web access
- 🎨 **Rich UI**: Beautiful terminal interfaces
- 🔧 **File Processing**: Advanced file operations
- 📁 **Session Management**: Named conversation sessions
---

## 📖 **Documentation Links**

- **🏠 Homepage**: [GitHub Repository](https://github.com/AIMLDev726/ai-helper-agent)
- **🐛 Issues**: [Bug Tracker](https://github.com/AIMLDev726/ai-helper-agent/issues)  
- **📝 Changelog**: [Full Version History](CHANGELOG.md)
- **🤝 Contributing**: [Contribution Guide](CONTRIBUTING.md)
- **📜 License**: [MIT License](LICENSE)

---

## 🌍 **Community & Support**

### **Getting Help**
- 📧 **Email**: aistudentlearn4@gmail.com
- 🐛 **GitHub Issues**: Report bugs and request features
- 💬 **Discussions**: Share tips and ask questions

### **Contributing**
We welcome contributions! Areas where you can help:
- 🐛 Bug fixes and improvements
- 📚 Documentation updates  
- 🌟 New features and integrations
- 🧪 Testing and quality assurance

---

## 📄 **License**

This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

**Free for personal and commercial use!** ✅

---

## 🙏 **Acknowledgments**

- **🚀 Built with**: [LangChain](https://langchain.com/) framework
- **🎨 UI powered by**: [Rich](https://rich.readthedocs.io/) library  
- **🤖 AI providers**: Groq, OpenAI, Anthropic, Google, G4F
- **💡 Inspired by**: GitHub Copilot, ChatGPT, and the open-source community

---

## 🎉 **Ready to Get Started?**

```bash
# Install
pip install ai-helper-agent

# Try the flagship (free!)
ai-super-chat

# Or choose your interface
ai-menu
```

**Happy Coding with AI! 🚀✨**

---

**Made with ❤️ by [AIMLDev726](https://github.com/AIMLDev726)**