Package Exports
- @bonginkan/maria
- @bonginkan/maria/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@bonginkan/maria) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
🤖 MARIA Platform v2.1.9 "Enhanced UX & Advanced Content Analysis Edition"
🎉 MARIA Platform v2.1.9 - Revolutionary AI Development CLI with Advanced Image Processing, Cloud Vision AI, Enhanced UX Components, CLI Native Development, 50+ Professional Commands, Complete Microservices Architecture, Ultra Memory System, and Privacy-First Local Development!
🖥️ MARIA CLI Interface
MARIA's enhanced CLI interface with professional progress reporting, mode indicators, and real-time feedback
⭐ What's New in v2.1.9
🎨 Phase 3 & 4: Enhanced UX & Advanced Content Analysis
📸 Cloud Vision AI Integration
- Gemini 2.0 Flash (Primary): Google's latest vision model for high-quality image analysis
- GPT-4o-mini Vision (Fallback): OpenAI's vision API for comprehensive analysis
- Local OCR Fallback: Tesseract.js integration for offline processing
- Smart Network Detection: Seamless switching between cloud and local processing
📊 Professional UX Components
- Real-Time Feedback Manager: 6 message types with auto-dismissal and rich styling
- Enhanced Progress Reporter: Animated progress bars with timing and session management
- Advanced Mode Indicators: 58+ cognitive modes with animations and intensity levels
- Typing Indicators: Professional spinner animations for processing states
🔧 CLI Native Development System
- 50+ New Commands: Complete development workflow in terminal
- Parallel Execution Engine: Multi-core task processing with dependency resolution
- Advanced File Operations: Smart search, bulk editing, intelligent organization
- Enterprise Safety Systems: Dry-run mode, backups, rollback capabilities
🏗️ Complete Microservices Architecture
- Service Orchestration: Kubernetes-native deployment with auto-scaling
- API Gateway: Enterprise routing with authentication and rate limiting
- Service Discovery: Multi-registry support with load balancing
- Audit Logging: Complete operation tracking with compliance reporting
🚀 Quick Start
Installation
npm install -g @bonginkan/maria
maria
Setup Local AI (Optional)
# Ollama (Recommended)
maria setup-ollama
# vLLM (High Performance)
maria setup-vllm
🌟 Core Features
🧠 Revolutionary Dual-Layer Memory System
- System 1 (Fast/Intuitive): Instant pattern recognition with image processing
- System 2 (Deliberate/Analytical): Deep reasoning with content analysis
- Cross-Session Learning: Memory persists across all your development sessions
- Adaptive Intelligence: Learns your coding patterns and preferences
📸 Advanced Image Processing
# Cloud Vision Analysis
maria analyze-image screenshot.png "What UI issues do you see?"
# OCR Text Extraction
maria extract-text document.jpg
# Auto-Research from Images
# Drop any image with URLs or code - MARIA will auto-research relevant topics
🎯 58+ Cognitive Modes
- Self-Questioning: Automatically active for comprehensive analysis
- IntentSocratic: Resolves ambiguous requirements through smart questioning
- DeepThinking: Complex problem-solving with multi-step reasoning
- Creative: Innovative solutions and architecture design
- Implementation: Code generation with best practices
- Validation: Testing, security, and quality assurance
🏠 Complete Local LLM Integration
- Automatic Detection: Auto-configures Ollama, vLLM, LM Studio
- Privacy-First: All processing runs locally on your machine
- Zero Cloud Dependencies: Work offline with full AI capabilities
- Multi-Model Support: 20+ local models supported
📋 Commands Overview
🎨 Content Analysis Commands
maria /analyze-content file.pdf # PDF analysis with vision AI
maria /extract-code image.png # Code extraction from screenshots
maria /research-topic "machine learning" # Auto-research with citations
maria /deep-dive "REST API design" # Comprehensive topic analysis
🔧 Development Commands
maria /code-review # AI-powered code review
maria /refactor-component Button.tsx # Smart refactoring
maria /generate-tests api.js # Auto-generate test suites
maria /optimize-performance # Performance analysis and fixes
🛠️ System Commands
maria status # System health check
maria models # List available AI models
maria setup # Interactive setup wizard
maria health --watch # Continuous monitoring
🎯 Use Cases
👨💻 For Developers
- Code Analysis: Upload screenshots of error messages for instant solutions
- Architecture Review: Drop diagrams for architectural feedback and improvements
- Documentation: Auto-generate docs from code screenshots or files
- Learning: Research new technologies with comprehensive analysis
🏢 For Teams
- Code Reviews: Enhanced review process with AI-powered insights
- Knowledge Sharing: Cross-session memory builds team knowledge base
- Standards Compliance: Automated code quality and security checks
- Onboarding: New developers get instant help and context
🔬 For Research
- Paper Analysis: Upload research papers for summarization and insights
- Data Visualization: Analyze charts and graphs from documents
- Literature Review: Auto-research topics with citation management
- Trend Analysis: Track technology trends and developments
⚡ Performance & Privacy
🚀 Enhanced Performance
- 60% Faster Startup: Optimized initialization with intelligent caching
- Real-Time Processing: Sub-100ms response times for most operations
- Parallel Execution: Multi-core processing for complex tasks
- Memory Optimization: Advanced memory management for large projects
🔒 Privacy-First Design
- Local Processing: All AI processing can run entirely offline
- No Data Collection: Your code and data never leave your machine
- Encrypted Memory: All session data encrypted at rest
- Compliance Ready: GDPR, CCPA, and enterprise security standards
🏗️ Architecture
🎯 Microservices Architecture
- Service Mesh: Complete service-to-service communication
- Auto-Scaling: Dynamic resource allocation based on demand
- Health Monitoring: Real-time service health and performance tracking
- Circuit Breakers: Fault tolerance and graceful degradation
🔧 Technical Stack
- Runtime: Node.js 18+ with TypeScript 5.0+
- UI Framework: Blessed.js for rich terminal interfaces
- AI Integration: OpenAI, Anthropic, Google, Groq, Local LLMs
- Image Processing: Tesseract.js, Sharp, Canvas APIs
- Database: SQLite with encryption for local storage
📖 Documentation
- Setup Guide - Complete installation and configuration
- Getting Started - Your first steps with MARIA
- Commands Reference - Complete command documentation
- Developer Guide - Advanced usage and customization
- Release Notes - Latest features and improvements
🤝 Community & Support
- GitHub Issues: Report bugs and request features
- Discussions: Join the community
- Documentation: Comprehensive guides and tutorials
🚀 Get Started Now
# Install MARIA
npm install -g @bonginkan/maria
# Start your AI development journey
maria
# Setup local AI (optional)
maria setup-ollama
# Try image analysis
maria analyze-image screenshot.png "Analyze this UI"
Experience the future of AI-powered development with MARIA v2.1.9! 🚀
Made with ❤️ by Bonginkan Inc.
Empowering developers with AI-powered tools and privacy-first solutions