maahelper 0.0.5

MaaHelper - Advanced AI-powered coding assistant with real-time analysis and Git integration

🙏 MaaHelper v0.0.5

Advanced AI-Powered Coding Assistant with Real-time Analysis & Git Integration

Created by Meet Solanki (AIML Student)

✨ Features

🎯 Core Features

• 🎨 Rich CLI: Real-time streaming, beautiful panels, markdown/code rendering
• 🤖 Multi-Provider AI: OpenAI, Groq, Anthropic, Google, Ollama
• 📁 AI File Analysis: file-search <filepath> for code/data/doc files
• 🔐 Secure API Key Management: Local encrypted storage in C:/Users/<username>/.maahelper/
• 💬 Interactive Chat: Persistent conversation history, context-aware
• 🚀 Async Performance: Fast streaming, low memory, instant startup
• 📊 Live Stats: Session, file, and model metrics

🆕 New in v0.0.5

• 🤖 Custom Agent Prompts (Vibecoding): Specialized AI workflows for coding tasks
• 🔍 Dynamic Model Discovery: Auto-fetch latest models from all providers
• 📊 Real-time Code Analysis: Live error detection and suggestions
• 🔧 Smart Git Integration: AI-powered commit messages and branch suggestions
• ⚡ Enhanced Performance: Rate limiting, memory management, and caching

🚀 Quick Start

Installation

pip install maahelper

📓 Complete Tutorial

NEW: Interactive Jupyter notebook with step-by-step guide!

# Download and run the complete tutorial
jupyter notebook MaaHelper_Getting_Started.ipynb

The notebook covers:

• ✅ Installation & API key setup
• ✅ Basic to advanced usage
• ✅ All new v0.0.5 features
• ✅ Pro tips and workflows

Usage

# Start the CLI
maahelper

# Try new v0.0.5 commands
> prompts             # 🆕 List custom AI agent prompts
> code-review         # 🆕 AI-powered code review
> bug-analysis        # 🆕 Deep bug analysis
> discover-models     # Auto-discover latest AI models
> analyze-start       # Start real-time code analysis
> git-commit          # AI-powered smart commits

# Or run via Python
python -m maahelper.cli.modern_enhanced_cli

API Key Setup

On first run, you'll be prompted to enter API keys for Groq, OpenAI, etc. These are securely stored in:

C:/Users/<username>/.maahelper/config.json

You can manage, edit, or delete keys via the Rich UI manager:

maahelper-keys

🎯 Core Commands

Basic

• help — Show help
• exit, quit, bye — Exit
• clear — Clear history
• status — Show config

File

• file-search <filepath> — AI file analysis
• files — Show files
• dir — Show directory

Config

• providers — List providers
• models — List models

🤖 Supported AI Providers

Provider	Models	Notes
Groq	Llama 3.1, Llama 3.2, Mixtral, Gemma	⚡ Fastest & Free
OpenAI	GPT-4, GPT-3.5-turbo	🧠 Most capable
Anthropic	Claude 3, Claude 2	📝 Great for analysis
Google	Gemini Pro, Gemini Flash	🔍 Multimodal support
Ollama	Local models	🏠 Privacy-focused

📁 File Analysis Example

You: file-search src/main.py

🤖 AI Assistant
Analyzing your Python file...

File Analysis: src/main.py

File Type: Python Source Code
Size: 1.2KB
Language: Python 3.8+

### Key Components:
- Main Function: Entry point with argument parsing
- Error Handling: Comprehensive try-catch blocks
- Dependencies: requests, json, argparse

### Code Quality:
✅ Good Clean structure and readable code
⚠️ Suggestion: Add type hints for better maintainability
⚠️ Suggestion: Consider adding docstrings

### Recommendations:
1. Add input validation for user arguments
2. Implement logging for better debugging
3. Consider async/await for API calls

🎨 Rich CLI Features

• Live Streaming: See AI responses in real-time
• Syntax Highlighting: Code blocks with proper formatting
• Progress Indicators: Visual feedback for operations
• Interactive Menus: Beautiful provider and model selection
• Error Handling: Elegant error messages with helpful suggestions

🔧 Configuration

API Key Management

MaaHelper uses a secure local configuration system:

C:\Users\{username}\.maahelper\
├── config.json          # Encrypted API keys
├── conversation_history/ # Chat sessions
└── logs/                # Application logs

Environment Variables

# Recommended method
export GROQ_API_KEY="gsk_..."
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GOOGLE_API_KEY="AIza..."

📊 Performance

• Streaming Speed: Up to 500+ tokens/second with Groq
• Memory Usage: < 50MB typical usage
• Startup Time: < 2 seconds cold start
• File Analysis: Processes files up to 10MB

🛠️ Development

Requirements

• Python 3.8+
• Rich >= 13.0.0
• OpenAI >= 1.0.0
• Cryptography >= 3.4.0

Installation for Development

git clone https://github.com/AIMLDev726/maahelper.git
cd maahelper
pip install -e .

📝 Examples

Basic Chat

You: Explain async/await in Python

🤖 AI Assistant
# Async/Await in Python

**Async/await** is Python's way of handling asynchronous programming...

File Analysis

You: file-search requirements.txt

🤖 AI Assistant
## Dependency Analysis

Your project has **12 dependencies**:
- **Core**: openai, rich, cryptography
- **Optional**: anthropic, google-generativeai
- **Development**: pytest, black, flake8

Code Review

You: Review this function for bugs

🤖 AI Assistant
## Code Review Results

✅ **Good Practices**:
- Clear function naming
- Proper error handling

⚠️ **Issues Found**:
- Missing input validation on line 15
- Potential memory leak in loop (line 23)

Demo Video

📚 Documentation

📓 Getting Started

• MaaHelper_Getting_Started.ipynb - Complete interactive tutorial
• FEATURES_v0.0.5.md - Detailed feature documentation
• CHANGELOG.md - Version history and changes

🏗️ Development

• CODE_STRUCTURE.md - Complete architecture documentation
• CLEANUP_REPORT.md - Code quality improvements

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

🏗️ Development Setup

# Clone the repository
git clone https://github.com/AIMLDev726/maahelper.git
cd maahelper

# Install in development mode
pip install -e .

# Run tests
pytest tests/

# Check code structure
cat CODE_STRUCTURE.md

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Created by Meet Solanki (AIML Student)

• GitHub: @AIMLDev726
• Email: [e-mail]

🙏 Acknowledgments

• Built with Rich for beautiful CLI
• Powered by OpenAI and multiple AI providers
• Thanks to the open-source Python community

---

⭐ Star this repository if you find it helpful!