# ๐ค AI Helper Agent v2.0.1
[](https://pypi.org/project/ai-helper-agent/)
[](https://www.python.org/downloads/)
[](LICENSE)
[](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)**
Raw data
{
"_id": null,
"home_page": "https://github.com/AIMLDev726/ai-helper-agent",
"name": "ai-helper-agent",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "AIMLDev726 <aistudentlearn4@gmail.com>",
"keywords": "ai, assistant, programming, code-analysis, bug-fixing, automation, groq, openai, anthropic, google, langchain, internet-search, cli, developer-tools, ai-agent",
"author": "Meet Solanki (AIML Student)",
"author_email": "\"Meet Solanki (AIML Student)\" <aistudentlearn4@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/3a/cd/a9b56e8f3dd76d9bbf2d1d6b998b7d93d4f0c2fe8022d7026013fcc5fdcb/ai_helper_agent-2.0.1.tar.gz",
"platform": "any",
"description": "# \ud83e\udd16 AI Helper Agent v2.0.1\r\n\r\n[](https://pypi.org/project/ai-helper-agent/)\r\n[](https://www.python.org/downloads/)\r\n[](LICENSE)\r\n[](https://pypi.org/project/ai-helper-agent/)\r\n\r\n**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.\r\n\r\n## \u26a1 **Performance Optimized**\r\n- **\ud83d\ude80 Lightning Fast**: Optimized lazy loading reduces startup time by 99.97%\r\n- **\u26a1 Sub-10ms**: CLI commands start in under 10 milliseconds\r\n- **\ud83c\udfaf Production Ready**: Thoroughly tested with 100% feature compatibility\r\n\r\n---\r\n\r\n## \ufffd **Quick Start**\r\n\r\n### **Installation**\r\n```bash\r\npip install ai-helper-agent\r\n```\r\n\r\n### **Main Commands**\r\n```bash\r\n# Primary AI Chat Interface (Recommended)\r\nai-helper # Enhanced multi-provider CLI with Rich UI\r\n\r\n# Quick Access Commands \r\nai-chat # Start AI conversation\r\nai-assist # AI assistance mode\r\nai-selector # Interactive provider selection\r\n\r\n# Specialized Interfaces\r\nai-groq # Fast Groq-powered responses\r\nai-openai # OpenAI GPT models\r\nai-anthropic # Claude models\r\nai-google # Google Gemini models\r\n\r\n# Internet-Enabled\r\nai-web # AI with web search capabilities\r\nai-search # Internet-powered AI queries\r\nai-internet # Web-enabled conversations\r\n```\r\n\r\n### **First Time Setup**\r\n```bash\r\n# Set your API key (choose one):\r\n$env:GROQ_API_KEY=\"your_groq_api_key\" # Windows\r\nexport GROQ_API_KEY=\"your_groq_api_key\" # Linux/Mac\r\n\r\n# Start chatting immediately\r\nai-helper\r\n```\r\n\r\n---\r\n\r\n## \ud83c\udf1f **Key Features**\r\n\r\n### **\ud83e\udd16 Multi-Provider AI Support**\r\n- \u2705 **Groq**: Ultra-fast inference (1000+ tokens/sec)\r\n- \u2705 **OpenAI**: GPT-3.5, GPT-4, and latest models\r\n- \u2705 **Anthropic**: Claude models with advanced reasoning\r\n- \u2705 **Google**: Gemini Pro with multimodal capabilities\r\n- \u2705 **Ollama**: Local model support (coming soon)\r\n\r\n### **\ud83c\udf10 Internet & Web Integration**\r\n- \u2705 **Smart Web Search**: DuckDuckGo and Google search integration\r\n- \u2705 **Real-time Information**: Access current data and latest updates\r\n- \u2705 **Web Content Processing**: Analyze and process web pages\r\n- \u2705 **Context-Aware Searches**: AI decides when to search the web\r\n\r\n### **\ud83c\udfa8 Rich Terminal Experience**\r\n- \u2705 **Beautiful UI**: Rich terminal formatting with tables and panels\r\n- \u2705 **Syntax Highlighting**: Code blocks with proper syntax highlighting\r\n- \u2705 **Streaming Responses**: Real-time response generation\r\n- \u2705 **Interactive Menus**: Easy provider and model selection\r\n\r\n### **\ud83d\udcbe Session Management**\r\n- \u2705 **Conversation History**: Persistent chat history across sessions\r\n- \u2705 **Session Export/Import**: Save and restore conversation states\r\n- \u2705 **Memory Management**: Context-aware conversation continuity\r\n- \u2705 **Multi-Session Support**: Separate conversations for different projects\r\n\r\n### **\ufffd Security & Privacy**\r\n- \u2705 **Encrypted API Keys**: Secure local storage with encryption\r\n- \u2705 **No Data Collection**: All processing happens locally\r\n- \u2705 **Secure Communications**: HTTPS for all API communications\r\n- \u2705 **Key Management**: Easy and secure API key administration\r\n\r\n---\r\n\r\n## \ud83d\udcda **Complete Command Reference**\r\n\r\n### **Primary Interfaces**\r\n| Command | Description | Best For |\r\n|---------|-------------|----------|\r\n| `ai-helper` | Enhanced multi-provider CLI | General use, rich features |\r\n| `ai-chat` | Primary chat interface | Quick conversations |\r\n| `ai-assist` | AI assistance mode | Code help and analysis |\r\n| `ai-selector` | Interactive menu | Choosing providers visually |\r\n\r\n### **Provider-Specific Commands**\r\n| Command | Provider | Strengths |\r\n|---------|----------|-----------|\r\n| `ai-groq` | Groq | Ultra-fast responses |\r\n| `ai-openai` | OpenAI | Most capable models |\r\n| `ai-anthropic` | Anthropic | Code analysis & reasoning |\r\n| `ai-google` | Google | Multimodal capabilities |\r\n| `ai-ollama` | Ollama | Local/private models |\r\n\r\n### **Internet-Enabled Commands**\r\n| Command | Features | Use Cases |\r\n|---------|----------|-----------|\r\n| `ai-web` | Enhanced web CLI | Research with AI |\r\n| `ai-search` | Internet search focus | Current information |\r\n| `ai-internet` | Web-enabled chat | Latest developments |\r\n| `ai-web-single` | Single provider + web | Fast web-enabled chat |\r\n\r\n### **Multi-Provider Commands**\r\n| Command | Description | Features |\r\n|---------|-------------|----------|\r\n| `ai-multi` | Full multi-provider | All providers available |\r\n| `ai-providers` | Provider management | Switch between models |\r\n\r\n### **Utility Commands**\r\n| Command | Purpose | Usage |\r\n|---------|---------|-------|\r\n| `ai-setup` | API key configuration | Initial setup |\r\n| `ai-config` | System configuration | Advanced settings |\r\n| `ai-version` | Version information | Check current version |\r\n| `ai-help` | Command help system | Get assistance |\r\n| `ai-status` | System status | Check functionality |\r\n\r\n### **Advanced Features**\r\n| Command | Feature | Description |\r\n|---------|---------|-------------|\r\n| `ai-stream` | Streaming mode | Real-time responses |\r\n| `ai-history` | View history | Browse past conversations |\r\n| `ai-clear` | Clear history | Reset conversation memory |\r\n| `ai-export` | Export conversations | Save chat history |\r\n| `ai-import` | Import conversations | Restore chat history |\r\n\r\n---\r\n\r\n## \ufffd **Getting API Keys**\r\n\r\n### **Free Options**\r\n- **Groq**: Free tier with generous limits \u2192 [console.groq.com](https://console.groq.com/keys)\r\n\r\n### **Premium Options**\r\n- **OpenAI**: GPT-4 access \u2192 [platform.openai.com](https://platform.openai.com/api-keys)\r\n- **Anthropic**: Claude models \u2192 [console.anthropic.com](https://console.anthropic.com/)\r\n- **Google**: Gemini Pro \u2192 [makersuite.google.com](https://makersuite.google.com/app/apikey)\r\n\r\n### **Setting API Keys**\r\n\r\n**Windows (PowerShell):**\r\n```powershell\r\n$env:GROQ_API_KEY=\"your_api_key_here\"\r\n$env:OPENAI_API_KEY=\"your_openai_key\"\r\n$env:ANTHROPIC_API_KEY=\"your_anthropic_key\"\r\n$env:GOOGLE_API_KEY=\"your_google_key\"\r\n```\r\n\r\n**Linux/Mac (Bash/Zsh):**\r\n```bash\r\nexport GROQ_API_KEY=\"your_api_key_here\"\r\nexport OPENAI_API_KEY=\"your_openai_key\"\r\nexport ANTHROPIC_API_KEY=\"your_anthropic_key\"\r\nexport GOOGLE_API_KEY=\"your_google_key\"\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udca1 **Usage Examples**\r\n\r\n### **Code Development**\r\n```bash\r\nai-helper\r\n> \"Write a Python function to implement quicksort\"\r\n> \"Explain this error: AttributeError: 'NoneType' object has no attribute 'split'\"\r\n> \"Optimize this code for better performance\"\r\n> \"Add error handling to this function\"\r\n```\r\n\r\n### **Web Research & Current Information**\r\n```bash\r\nai-web\r\n> \"What are the latest Python 3.12 features?\"\r\n> \"Current best practices for React development in 2024\"\r\n> \"Latest security vulnerabilities in Express.js\"\r\n> \"Compare FastAPI vs Flask performance benchmarks\"\r\n```\r\n\r\n### **Code Analysis & Review**\r\n```bash\r\nai-anthropic\r\n> \"Review this code for potential security issues\"\r\n> \"Suggest improvements for this algorithm\"\r\n> \"Explain the time complexity of this function\"\r\n> \"Generate unit tests for this class\"\r\n```\r\n\r\n### **Multi-Modal Tasks**\r\n```bash\r\nai-google\r\n> \"Analyze this image and generate corresponding code\"\r\n> \"Convert this flowchart to Python implementation\"\r\n> \"Explain this diagram in technical terms\"\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udee0 **Development & Advanced Usage**\r\n\r\n### **Python API**\r\n```python\r\nfrom ai_helper_agent.core import AIHelperCore\r\nfrom ai_helper_agent.providers import GroqProvider\r\n\r\n# Initialize with specific provider\r\ncore = AIHelperCore()\r\nprovider = GroqProvider(api_key=\"your_key\")\r\n\r\n# Process requests\r\nresponse = core.process_request(\r\n \"Explain async/await in Python\",\r\n provider=provider\r\n)\r\nprint(response)\r\n```\r\n\r\n### **Configuration**\r\n```python\r\nfrom ai_helper_agent.core.config import config\r\n\r\n# Customize settings\r\nconfig.set_default_provider(\"groq\")\r\nconfig.set_streaming_enabled(True)\r\nconfig.set_web_search_enabled(True)\r\n```\r\n\r\n### **Session Management**\r\n```python\r\nfrom ai_helper_agent.managers import ConversationManager\r\n\r\n# Create named sessions\r\nmanager = ConversationManager()\r\nsession = manager.create_session(\"project_analysis\")\r\n\r\n# Resume sessions\r\nsession = manager.get_session(\"project_analysis\")\r\n```\r\n\r\n---\r\n\r\n## \ud83c\udfa8 **Rich UI Features**\r\n\r\nThe AI Helper Agent provides a beautiful terminal experience with:\r\n\r\n- **\ufffd Tables**: Structured data presentation\r\n- **\ud83c\udfa8 Syntax Highlighting**: Code blocks with proper coloring\r\n- **\u26a1 Progress Bars**: Real-time operation feedback\r\n- **\ud83d\udccb Panels**: Organized information display\r\n- **\ud83c\udfaf Interactive Menus**: Easy navigation and selection\r\n- **\ud83d\udcac Streaming Text**: Real-time response generation\r\n\r\n---\r\n\r\n## \ud83d\udd27 **System Requirements**\r\n\r\n- **Python**: 3.8 or higher\r\n- **Operating System**: Windows, Linux, macOS\r\n- **Memory**: Minimum 512MB RAM\r\n- **Storage**: 100MB free space\r\n- **Network**: Internet connection for AI providers and web search\r\n\r\n---\r\n\r\n## \ud83d\udcd6 **Documentation**\r\n\r\n- **Quick Start**: Follow the examples above\r\n- **API Reference**: Check docstrings in the code\r\n- **Command Help**: Use `ai-help` for built-in assistance\r\n- **GitHub Wiki**: Detailed guides and tutorials\r\n\r\n---\r\n\r\n## \ud83e\udd1d **Contributing**\r\n\r\nWe welcome contributions! Please:\r\n\r\n1. Fork the repository\r\n2. Create a feature branch\r\n3. Make your changes\r\n4. Add tests if applicable\r\n5. Submit a pull request\r\n\r\n---\r\n\r\n## \ud83d\udcc4 **License**\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n---\r\n\r\n## \ud83d\ude4b **Support**\r\n\r\n- **GitHub Issues**: [Report bugs or request features](https://github.com/AIMLDev726/ai-helper-agent/issues)\r\n- **Email**: aistudentlearn4@gmail.com\r\n- **Documentation**: Check built-in help with `ai-help`\r\n\r\n---\r\n\r\n## \ud83c\udfaf **Why AI Helper Agent?**\r\n\r\n- **\u26a1 Fast**: Optimized for speed with lazy loading\r\n- **\ud83d\udd27 Flexible**: Multiple AI providers and models\r\n- **\ud83c\udf10 Connected**: Internet search and web integration\r\n- **\ud83c\udfa8 Beautiful**: Rich terminal UI experience\r\n- **\ud83d\udd12 Secure**: Encrypted API key storage\r\n- **\ud83d\udcf1 Simple**: Easy-to-remember commands\r\n- **\ud83d\ude80 Active**: Regular updates and improvements\r\n\r\n**Start coding smarter with AI Helper Agent!** \ud83d\ude80\r\n\r\n# View existing keys (masked for security)\r\npython -m ai_helper_agent.utilities.api_key_setup list\r\n\r\n# Test API key connections\r\npython -m ai_helper_agent.utilities.api_key_setup test\r\n\r\n# Remove keys\r\npython -m ai_helper_agent.utilities.api_key_setup remove groq\r\n\r\n# Show help\r\npython -m ai_helper_agent.utilities.api_key_setup --help\r\n```\r\n\r\n### **\ud83c\udd93 No API Key Required Options:**\r\n\r\n- **G4F (GPT4Free)**: Use `ai-super-chat` for FREE GPT-4 access\r\n- **Local Models**: Coming soon with Ollama integration\r\n\r\n### **\ud83d\udd10 Security Features:**\r\n- \u2705 **Encrypted Storage**: All keys encrypted at rest\r\n- \u2705 **Local Storage**: Keys never leave your machine\r\n- \u2705 **Masked Display**: Keys shown as `gsk_***...***xyz`\r\n- \u2705 **Secure Prompts**: Password-style input for keys\r\n\r\n---\r\n\r\n## \ud83d\udce6 **Installation**\r\n\r\n### **Simple Installation:**\r\n```bash\r\npip install ai-helper-agent\r\n```\r\n\r\n### **Development Installation:**\r\n```bash\r\ngit clone https://github.com/AIMLDev726/ai-helper-agent\r\ncd ai-helper-agent\r\npip install -e .\r\n```\r\n\r\n---\r\n\r\n## \ud83c\udfaf **Features Overview**\r\n\r\n### **\ud83c\udf1f Core Capabilities**\r\n- \u2705 **Multi-Provider AI**: Groq, OpenAI, Anthropic, Google AI, G4F\r\n- \u2705 **Free G4F Access**: No API keys needed for GPT-4\r\n- \u2705 **Internet Search**: Real-time web access and current information\r\n- \u2705 **File Processing**: Analyze, modify, and generate files\r\n- \u2705 **Browser Automation**: Web integration and automation tools\r\n- \u2705 **MCP Integration**: Model Context Protocol support\r\n- \u2705 **Code Generation**: Natural language to code conversion\r\n- \u2705 **Rich UI**: Beautiful terminal interfaces with tables and formatting\r\n- \u2705 **Session Memory**: Persistent conversation history\r\n- \u2705 **40+ Commands**: User-friendly CLI ecosystem\r\n\r\n### **\ud83d\udd27 Advanced Features**\r\n- \ud83c\udfa8 **Syntax Highlighting**: Beautiful code rendering with Rich UI\r\n- \ud83d\udd0d **Smart Search**: AI decides when to search the web\r\n- \ud83d\udcbe **Session Management**: Named sessions for different projects\r\n- \u26a1 **Streaming Responses**: Real-time response generation\r\n- \ud83d\udee1\ufe0f **Security Controls**: Encrypted API key storage\r\n- \ud83d\udcc1 **Workspace Integration**: Context-aware file operations\r\n- \ud83c\udf10 **Browser Tools**: Web automation and scraping capabilities\r\n- \ud83d\udd17 **MCP Protocol**: Advanced context management\r\n- \ud83d\udcca **Rich Help System**: Beautiful help for all commands\r\n\r\n### **\ud83c\udfa8 User Experience**\r\n- \ud83c\udfaf **Easy Commands**: Non-technical names like `ai-super-chat`\r\n- \ud83d\udccb **Interactive Menu**: Visual CLI selector with `ai-menu`\r\n- \ud83c\udfa8 **Rich UI**: Tables, colors, and beautiful formatting\r\n- \u26a1 **Quick Access**: Aliases like `ai-quick`, `ai-search`\r\n- \ud83d\udd27 **Developer Tools**: Advanced features with `ai-advanced`\r\n\r\n---\r\n\r\n## \ud83d\ude80 **Quick Examples**\r\n\r\n### **\ud83c\udf1f Flagship - Free AI with Internet**\r\n```bash\r\nai-super-chat # Start the flagship experience\r\n\r\n# Example conversations:\r\n> \"What's the latest Python 3.12 features with examples?\"\r\n> \"How to deploy FastAPI to AWS in 2024?\"\r\n> \"Show me the newest React 18 hooks with code examples\"\r\n> \"Debug this error: ModuleNotFoundError tensorflow\"\r\n> \"Latest Django 5.0 tutorial with step-by-step guide\"\r\n```\r\n\r\n### **\u26a1 Lightning Fast Responses**\r\n```bash\r\nai-quick # Ultra-fast Groq responses\r\n\r\n# Perfect for:\r\n> \"Write a Python function to sort a list\"\r\n> \"Explain this code: async def main():\"\r\n> \"Convert this to TypeScript: const data = []\"\r\n> \"Fix this syntax error in my function\"\r\n```\r\n\r\n### **\ud83c\udf10 Web-Enabled Development**\r\n```bash\r\nai-search # Internet-powered development\r\n\r\n# Ideal for:\r\n> \"Latest Django 5.0 tutorial with examples\"\r\n> \"Current best practices for React 18 in 2024\"\r\n> \"How to fix CORS errors in Express.js latest version\"\r\n> \"Compare FastAPI vs Flask performance 2024\"\r\n```\r\n\r\n### **\ud83e\udd16 Multi-Provider Power**\r\n```bash\r\nai-multi # Choose your AI provider\r\n\r\n# Available providers:\r\n# - Groq (Ultra-fast, 1000+ tokens/sec)\r\n# - OpenAI (GPT-4, most capable)\r\n# - Anthropic (Claude, great for code analysis)\r\n# - Google (Gemini, multimodal capabilities)\r\n# - G4F (Free GPT-4 access)\r\n```\r\n\r\n### **\ud83d\udd27 Developer Toolkit**\r\n```bash\r\nai-dev # Advanced development features\r\n\r\n# Advanced capabilities:\r\n> \"Analyze all Python files in this project\"\r\n> \"Review this code for security vulnerabilities\"\r\n> \"Generate comprehensive unit tests for my functions\"\r\n> \"Optimize the performance of this entire codebase\"\r\n> \"Create documentation for this API\"\r\n```\r\n\r\n### **\ud83d\udee0\ufe0f System Tools**\r\n```bash\r\n# Browser automation and web tools\r\nai-browser # Web automation features\r\n\r\n# MCP integration for advanced context\r\nai-mcp # Model Context Protocol tools\r\n\r\n# Core system functionality\r\nai-core # Core system tools and utilities\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udcda **Complete Command Reference**\r\n\r\n### **\ud83c\udfaf Main Chat CLIs:**\r\n| Command | Purpose | Features |\r\n|---------|---------|----------|\r\n| `ai-super-chat` | \ud83c\udf1f Flagship (FREE G4F + Internet) | Free GPT-4, Web search, Rich UI |\r\n| `ai-fast-chat` | \u26a1 Ultra-fast (Groq only) | Lightning speed, 1000+ tokens/sec |\r\n| `ai-web-chat` | \ud83c\udf10 Internet-enabled (Groq + Web) | Smart web search, current info |\r\n| `ai-smart-chat` | \ud83e\udd16 Multi-provider | All AI providers, model selection |\r\n| `ai-advanced` | \ud83d\udd27 Developer toolkit | File processing, code analysis |\r\n| `ai-menu` | \ud83d\udccb Interactive selector | Visual CLI chooser |\r\n\r\n### **\ud83d\udee0\ufe0f System & Utility Commands:**\r\n| Command | Purpose | Features |\r\n|---------|---------|----------|\r\n| `ai-setup-keys` | \ud83d\udd11 API key management | Interactive wizard, secure setup |\r\n| `ai-browser` | \ud83c\udf10 Browser automation | Web scraping, automation tools |\r\n| `ai-mcp` | \ud83d\udd17 MCP integration | Model Context Protocol |\r\n| `ai-core` | \u2699\ufe0f Core system tools | System functionality |\r\n\r\n### **\u26a1 Quick Access Aliases:**\r\n| Alias | Main Command | Usage |\r\n|-------|-------------|--------|\r\n| `ai-quick` | `ai-fast-chat` | Ultra-fast responses |\r\n| `ai-search` | `ai-web-chat` | Internet-powered queries |\r\n| `ai-multi` | `ai-smart-chat` | Multi-provider access |\r\n| `ai-dev` | `ai-advanced` | Developer features |\r\n| `ai-keys` | `ai-setup-keys` | Key management |\r\n\r\n---\r\n\r\n## \ud83d\udc0d **Python API Usage**\r\n\r\n### **Basic Usage:**\r\n```python\r\nfrom ai_helper_agent import create_agent\r\n\r\n# Create an agent instance\r\nagent = create_agent()\r\n\r\n# Ask for help\r\nresponse = agent.process_request(\"How do I implement a binary search in Python?\")\r\nprint(response)\r\n```\r\n\r\n### **Advanced Configuration:**\r\n```python\r\nfrom ai_helper_agent import InteractiveAgent\r\nfrom ai_helper_agent.config import config\r\n\r\n# Customize configuration\r\nconfig.update({\r\n 'temperature': 0.7,\r\n 'max_tokens': 2048,\r\n 'provider': 'groq',\r\n 'model': 'llama-3.1-70b'\r\n})\r\n\r\n# Create agent with custom settings\r\nagent = InteractiveAgent()\r\n```\r\n\r\n### **File Operations:**\r\n```python\r\nfrom ai_helper_agent import InteractiveAgent\r\n\r\nagent = InteractiveAgent()\r\n\r\n# Analyze a file\r\nresponse = agent.process_request(\"Analyze the code in myfile.py\")\r\n\r\n# Get optimization suggestions \r\nresponse = agent.process_request(\"Optimize the performance of myfile.py\")\r\n\r\n# Generate unit tests\r\nresponse = agent.process_request(\"Create unit tests for functions in mymodule.py\")\r\n```\r\n\r\n### **Internet-Enabled Queries:**\r\n```python\r\nfrom ai_helper_agent import InternetAgent\r\n\r\n# Create internet-enabled agent\r\nagent = InternetAgent()\r\n\r\n# Ask current questions\r\nresponse = agent.process_request(\"What are the latest Python 3.12 features?\")\r\n\r\n# Technical documentation queries\r\nresponse = agent.process_request(\"Show me FastAPI async database examples\")\r\n```\r\n\r\n### **\ud83c\udfa8 Rich Help System**\r\nEvery CLI has beautiful, comprehensive help:\r\n\r\n```bash\r\nai-super-chat --help # Flagship features and commands\r\nai-web-chat --help # Internet search capabilities \r\nai-advanced --help # Developer toolkit overview\r\nai-smart-chat --help # Multi-provider options\r\n```\r\n\r\n### **\ud83d\udd04 Session Management**\r\n```bash\r\n# Named sessions for different projects\r\nai-dev --session backend-api\r\nai-search --session frontend-bugs\r\nai-quick --session quick-scripts\r\n\r\n# Quick mode (skip startup)\r\nai-super-chat --quick\r\nai-multi --quick\r\n```\r\n\r\n### **\ud83c\udf10 Internet Features**\r\n\r\n#### **Permission Levels:**\r\n- **Smart** (Default): AI decides when to search\r\n- **Always**: Search for every query \r\n- **Ask**: Prompt before searching\r\n- **Never**: Disable internet access\r\n\r\n#### **Internet Commands (in chat):**\r\n```bash\r\n# Manual search\r\n> internet search \"latest React features\"\r\n\r\n# Change permissions \r\n> internet permission smart\r\n> internet permission always\r\n> internet permission ask\r\n> internet permission never\r\n\r\n# Check status\r\n> internet\r\n```\r\n\r\n### **\ud83e\udd16 Provider-Specific Features**\r\n\r\n#### **Groq (Ultra-Fast)**\r\n- Models: Llama 3.1, Llama 3.3, Mixtral, Gemma\r\n- Speed: ~1000 tokens/second\r\n- Best for: Quick responses, coding tasks\r\n\r\n#### **OpenAI (Most Capable)** \r\n- Models: GPT-4, GPT-4 Turbo, GPT-3.5 Turbo\r\n- Best for: Complex reasoning, creative tasks\r\n\r\n#### **Anthropic (Code Expert)**\r\n- Models: Claude 3.5 Sonnet, Claude 3 Haiku \r\n- Best for: Code analysis, safety-focused tasks\r\n\r\n#### **Google (Multimodal)**\r\n- Models: Gemini Pro, Gemini 1.5 Pro\r\n- Best for: Mixed content, vision tasks\r\n\r\n#### **G4F (Free GPT-4)**\r\n- Models: GPT-4, GPT-3.5, Various others\r\n- Cost: 100% Free\r\n- Best for: General use without API costs\r\n\r\n---\r\n\r\n## \ud83d\udee0\ufe0f **Configuration & Setup**\r\n\r\n### **Environment Variables**\r\n```bash\r\n# Optional: Set default provider\r\nexport AI_HELPER_DEFAULT_PROVIDER=groq\r\n\r\n# Optional: Set default model\r\nexport AI_HELPER_DEFAULT_MODEL=llama-3.1-70b\r\n\r\n# Optional: Custom workspace\r\nexport AI_HELPER_WORKSPACE=/path/to/project\r\n```\r\n\r\n### **Config File (Optional)**\r\nCreate `~/.ai-helper-agent/config.yaml`:\r\n```yaml\r\ndefault_provider: groq\r\ndefault_model: llama-3.1-70b\r\ntemperature: 0.7\r\nmax_tokens: 4096\r\ninternet_permission: smart\r\nsession_persistence: true\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udd10 **Security & Privacy**\r\n\r\n### **API Key Security**\r\n- \u2705 **Encrypted Storage**: All keys encrypted at rest\r\n- \u2705 **Local Storage**: Keys never leave your machine\r\n- \u2705 **Masked Display**: Keys shown as `gsk_***...***xyz`\r\n- \u2705 **Secure Prompts**: Password-style input for keys\r\n\r\n### **Internet Privacy**\r\n- \u2705 **User Control**: You control when internet is accessed\r\n- \u2705 **Transparent**: AI tells you when it searches\r\n- \u2705 **Configurable**: Set permission levels\r\n- \u2705 **No Tracking**: Searches are not logged or tracked\r\n\r\n### **File Security**\r\n- \u2705 **Workspace Isolation**: Operations limited to workspace\r\n- \u2705 **Permission Checks**: Confirms before file modifications\r\n- \u2705 **Backup Options**: Can create backups before changes\r\n- \u2705 **Read-Only Mode**: Available for analysis-only tasks\r\n\r\n---\r\n\r\n## \ud83c\udfaf **Use Cases & Examples**\r\n\r\n### **\ud83d\ude80 Web Development**\r\n```bash\r\nai-search\r\n\r\n> \"Create a Next.js 14 app with TypeScript and Tailwind\"\r\n> \"How to implement authentication with NextAuth.js?\" \r\n> \"Debug CORS issues in my Express API\"\r\n> \"Latest React 18 best practices for state management\"\r\n```\r\n\r\n### **\ud83d\udc0d Python Development**\r\n```bash\r\nai-dev\r\n\r\n> \"Analyze this Flask app for security vulnerabilities\"\r\n> \"Generate FastAPI endpoints from this database schema\"\r\n> \"Optimize this pandas data processing code\"\r\n> \"Create unit tests for all functions in this file\"\r\n```\r\n\r\n### **\ud83d\udcf1 Mobile Development**\r\n```bash\r\nai-multi --provider anthropic\r\n\r\n> \"Convert this React component to React Native\"\r\n> \"Create Flutter widgets for this design\"\r\n> \"Implement SwiftUI navigation patterns\"\r\n> \"Debug Android build.gradle dependencies\"\r\n```\r\n\r\n### **\ud83d\udd2c Data Science**\r\n```bash\r\nai-super-chat\r\n\r\n> \"What's the latest in machine learning frameworks?\"\r\n> \"Create a PyTorch model for image classification\" \r\n> \"Analyze this dataset and suggest visualizations\"\r\n> \"Compare TensorFlow vs PyTorch for NLP tasks\"\r\n```\r\n\r\n### **\u2601\ufe0f DevOps & Deployment**\r\n```bash\r\nai-expert\r\n\r\n> \"Create Docker setup for this Python app\"\r\n> \"Generate Kubernetes deployment manifests\"\r\n> \"Set up CI/CD pipeline for GitHub Actions\"\r\n> \"Configure AWS Lambda deployment with Terraform\"\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udea8 **Troubleshooting**\r\n\r\n### **Common Issues**\r\n\r\n#### **\"Command not found\" Error**\r\n```bash\r\n# Reinstall to fix PATH issues\r\npip install --force-reinstall ai-helper-agent\r\n\r\n# Or use Python module syntax\r\npython -m ai_helper_agent.cli.cli_selector\r\n```\r\n\r\n#### **API Key Issues**\r\n```bash\r\n# Check if keys are set\r\npython -m ai_helper_agent.utilities.api_key_setup list\r\n\r\n# Test connections\r\npython -m ai_helper_agent.utilities.api_key_setup test\r\n\r\n# Re-add problematic keys\r\npython -m ai_helper_agent.utilities.api_key_setup add groq\r\n```\r\n\r\n#### **Internet Search Not Working**\r\n```bash\r\n# Check internet permission\r\n> internet\r\n\r\n# Enable internet access\r\n> internet permission smart\r\n\r\n# Manual search test\r\n> internet search \"test query\"\r\n```\r\n\r\n#### **Rich UI Display Issues**\r\n```bash\r\n# Update Rich library\r\npip install --upgrade rich\r\n\r\n# Check terminal compatibility\r\npython -c \"from rich.console import Console; Console().print('\u2705 Rich working')\"\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udd04 **Version History**\r\n\r\n### **v2.0.1 (Current) - August 2025**\r\n- \u2705 **User-Friendly Commands**: Easy-to-remember CLI names\r\n- \u2705 **Rich UI Help**: Beautiful help system for all CLIs\r\n- \u2705 **Fixed Coroutine Issues**: Resolved async/await problems\r\n- \u2705 **Enhanced Security**: Improved API key management\r\n- \u2705 **Command Aliases**: Multiple names for each CLI\r\n- \u2705 **Better Error Handling**: More helpful error messages\r\n\r\n### **v1.0.0 - JUly 2024**\r\n- \ud83c\udf1f **G4F Integration**: Free GPT-4 access\r\n- \ud83c\udf10 **Internet Search**: Real-time web access\r\n- \ud83c\udfa8 **Rich UI**: Beautiful terminal interfaces\r\n- \ud83d\udd27 **File Processing**: Advanced file operations\r\n- \ud83d\udcc1 **Session Management**: Named conversation sessions\r\n---\r\n\r\n## \ud83d\udcd6 **Documentation Links**\r\n\r\n- **\ud83c\udfe0 Homepage**: [GitHub Repository](https://github.com/AIMLDev726/ai-helper-agent)\r\n- **\ud83d\udc1b Issues**: [Bug Tracker](https://github.com/AIMLDev726/ai-helper-agent/issues) \r\n- **\ud83d\udcdd Changelog**: [Full Version History](CHANGELOG.md)\r\n- **\ud83e\udd1d Contributing**: [Contribution Guide](CONTRIBUTING.md)\r\n- **\ud83d\udcdc License**: [MIT License](LICENSE)\r\n\r\n---\r\n\r\n## \ud83c\udf0d **Community & Support**\r\n\r\n### **Getting Help**\r\n- \ud83d\udce7 **Email**: aistudentlearn4@gmail.com\r\n- \ud83d\udc1b **GitHub Issues**: Report bugs and request features\r\n- \ud83d\udcac **Discussions**: Share tips and ask questions\r\n\r\n### **Contributing**\r\nWe welcome contributions! Areas where you can help:\r\n- \ud83d\udc1b Bug fixes and improvements\r\n- \ud83d\udcda Documentation updates \r\n- \ud83c\udf1f New features and integrations\r\n- \ud83e\uddea Testing and quality assurance\r\n\r\n---\r\n\r\n## \ud83d\udcc4 **License**\r\n\r\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\r\n\r\n**Free for personal and commercial use!** \u2705\r\n\r\n---\r\n\r\n## \ud83d\ude4f **Acknowledgments**\r\n\r\n- **\ud83d\ude80 Built with**: [LangChain](https://langchain.com/) framework\r\n- **\ud83c\udfa8 UI powered by**: [Rich](https://rich.readthedocs.io/) library \r\n- **\ud83e\udd16 AI providers**: Groq, OpenAI, Anthropic, Google, G4F\r\n- **\ud83d\udca1 Inspired by**: GitHub Copilot, ChatGPT, and the open-source community\r\n\r\n---\r\n\r\n## \ud83c\udf89 **Ready to Get Started?**\r\n\r\n```bash\r\n# Install\r\npip install ai-helper-agent\r\n\r\n# Try the flagship (free!)\r\nai-super-chat\r\n\r\n# Or choose your interface\r\nai-menu\r\n```\r\n\r\n**Happy Coding with AI! \ud83d\ude80\u2728**\r\n\r\n---\r\n\r\n**Made with \u2764\ufe0f by [AIMLDev726](https://github.com/AIMLDev726)**\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Advanced AI-Powered Programming Assistant with Multi-Provider Support, Internet Search, and 40+ CLI Commands",
"version": "2.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/AIMLDev726/ai-helper-agent/issues",
"Changelog": "https://github.com/AIMLDev726/ai-helper-agent/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/AIMLDev726/ai-helper-agent#readme",
"Homepage": "https://github.com/AIMLDev726/ai-helper-agent",
"Repository": "https://github.com/AIMLDev726/ai-helper-agent"
},
"split_keywords": [
"ai",
" assistant",
" programming",
" code-analysis",
" bug-fixing",
" automation",
" groq",
" openai",
" anthropic",
" google",
" langchain",
" internet-search",
" cli",
" developer-tools",
" ai-agent"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "baef7678ad72c6893156852bcae7563b0a71f8f2f29b7ba37af5b7e1e213d8b1",
"md5": "3d8b88dbf77b050b74259c175ba3e07a",
"sha256": "926c39bd8aa041eb188b5613e8158695031aff6f7dc455d793acd8dcc4bc5725"
},
"downloads": -1,
"filename": "ai_helper_agent-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d8b88dbf77b050b74259c175ba3e07a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 236006,
"upload_time": "2025-08-02T20:03:57",
"upload_time_iso_8601": "2025-08-02T20:03:57.140265Z",
"url": "https://files.pythonhosted.org/packages/ba/ef/7678ad72c6893156852bcae7563b0a71f8f2f29b7ba37af5b7e1e213d8b1/ai_helper_agent-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3acda9b56e8f3dd76d9bbf2d1d6b998b7d93d4f0c2fe8022d7026013fcc5fdcb",
"md5": "24763db0237189379ff608206d2ce538",
"sha256": "d21354016586544c56f2aeadf0d9647eb73fde01f55afeb8ab1001124e71de5b"
},
"downloads": -1,
"filename": "ai_helper_agent-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "24763db0237189379ff608206d2ce538",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 218695,
"upload_time": "2025-08-02T20:03:59",
"upload_time_iso_8601": "2025-08-02T20:03:59.023885Z",
"url": "https://files.pythonhosted.org/packages/3a/cd/a9b56e8f3dd76d9bbf2d1d6b998b7d93d4f0c2fe8022d7026013fcc5fdcb/ai_helper_agent-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-02 20:03:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AIMLDev726",
"github_project": "ai-helper-agent",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "langchain-groq",
"specs": [
[
">=",
"0.1.0"
]
]
},
{
"name": "langchain",
"specs": [
[
">=",
"0.1.0"
]
]
},
{
"name": "cryptography",
"specs": [
[
">=",
"41.0.0"
]
]
},
{
"name": "structlog",
"specs": [
[
">=",
"23.0.0"
]
]
},
{
"name": "pathlib2",
"specs": []
}
],
"lcname": "ai-helper-agent"
}
JSON
