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 v1.1.0 - Enterprise Code Quality Platform

🤖 MARIA Platform v1.1.0 is the world's most advanced AI-powered development platform featuring enterprise-grade code quality analysis, natural language understanding, and comprehensive development tools with support for 22+ AI models.

🎉 Phase 6 Complete - Enterprise Code Quality Platform with Bug Detection, Lint Analysis, Type Safety, and Security Review

⚠️ Node.js Compatibility Notice

Recommended: Node.js v22 or lower for best experience

# Check your Node.js version
node --version

# If using Node.js v24, switch to v22:
nvm install 22
nvm use 22

🚀 Quick Start

# Install globally (Node.js 18-22 recommended)
npm install -g @maria/cli

# Update to latest version
npm update -g @maria/cli

# Start interactive mode
maria

✨ Key Features

🧠 Interactive Router System

Natural Language Understanding: Interprets developer intentions and automatically routes to optimal commands
Context Awareness: Uses conversation history and project state for intelligent decision making
Multi-Step Execution: Decomposes complex tasks into executable steps
Auto Mode: Natural language → Automatic command execution

🤖 Multi-Model AI Support

Cloud Providers: OpenAI GPT-4o, Anthropic Claude, Google Gemini, Groq
Local Models: LM Studio, vLLM, Ollama (GPT-OSS, Qwen, Mistral)
Automatic Fallback: Seamlessly switches between providers
Task-Based Selection: Chooses optimal model for each task type

🎬 Media Generation

Video Generation: Text-to-Video and Image-to-Video with Wan 2.2
Image Generation: High-quality images with Qwen-Image
Batch Processing: Generate multiple variations
Resolution Control: 720p/1080p video, up to 1024x1024 images

⚡ Development Tools

Code Generation: Create entire features with context awareness
Code Review: Comprehensive analysis with actionable suggestions
Test Generation: Unit, integration, and E2E tests
Smart Commits: AI-generated conventional commit messages

📚 Commands

Core Commands

maria init              # Initialize MARIA in your project
maria chat              # Interactive mode (40+ slash commands)
maria code "prompt"     # Generate code with AI
maria vision image.png  # Analyze images with vision models
maria review            # Review code changes
maria test              # Generate tests
maria commit            # Create AI commit messages

Media Generation

maria video "A futuristic city"     # Generate AI video
maria image "Abstract art"         # Generate AI image

Interactive Slash Commands

In maria chat mode, use these commands:

/help - Show all commands
/status - System status
/model - Select AI model
/clear - Clear conversation
/config - Configuration panel
/video - Generate video
/image - Generate image
/pr-comments - Analyze PR comments
/review - Execute PR review
/exit - Exit interactive mode

🔧 Configuration

MARIA uses .maria-code.toml for configuration:

[project]
name = "my-project"
type = "typescript"

[ai]
default_provider = "openai"
fallback_provider = "local"

[ai.providers.openai]
api_key = "${OPENAI_API_KEY}"
model = "gpt-4o"

[ai.providers.local]
endpoint = "http://localhost:1234"
model = "gpt-oss-20b"

🌟 Example Usage

Create a REST API

maria code "Create a REST API with user authentication" --language typescript

Generate Tests

maria test src/ --framework jest --coverage

AI Video Generation

maria video "A red sports car racing through mountains" --model wan22-14b

Code Review

maria review --diff --suggestions --severity warning

📦 Installation Options

# Latest stable (Node.js 18-22)
npm install -g @maria/cli

# Update existing installation
npm update -g @maria/cli

# Development version
npm install -g @maria/cli@alpha

# Beta version
npm install -g @maria/cli@beta

# Run without installing
npx @maria/cli

🔌 AI Provider Setup

OpenAI

export OPENAI_API_KEY=your_key

Anthropic

export ANTHROPIC_API_KEY=your_key

Local Models (LM Studio)

Download LM Studio
Load a model (e.g., GPT-OSS, Mistral)
Start the server
MARIA auto-detects at http://localhost:1234

🎯 Use Cases

For Developers

Generate boilerplate code instantly
Review code for best practices
Create comprehensive test suites
Debug complex issues with AI assistance

For Teams

Standardize commit messages
Automate code reviews
Generate documentation
Create consistent APIs

For Learning

Understand new codebases quickly
Learn best practices
Get explanations for complex code
Practice with AI pair programming

🛠️ System Requirements

Node.js: 18.0.0 - 22.x.x (v22 recommended, v24 not yet supported)
npm: 6.0.0 or higher
OS: macOS, Linux, Windows (WSL recommended)
Memory: 4GB RAM minimum (8GB+ for local models)
Storage: 500MB for CLI, varies for local models

🤝 Contributing

We welcome contributions! See Contributing Guide for details.

📚 Documentation

v1.1.0 Complete Documentation Suite

📋 Technical Specification - Complete technical specs, architecture, and implementation details
👨‍💻 Developer Guide - Comprehensive development guide with API reference, customization, and enterprise deployment
👤 User Manual - Complete user guide with step-by-step tutorials and best practices

Quick Documentation Access

Getting Started: User Manual - Getting Started
Code Quality Analysis: User Manual - Code Quality Analysis
Enterprise Deployment: Developer Guide - Enterprise Deployment
Troubleshooting: User Manual - Troubleshooting

MARIA Platform v1.1.0 - Experience the future of intelligent development with enterprise-grade code quality analysis.

📄 License

MIT License - see LICENSE for details.

🐛 Troubleshooting

Node.js v24 Compatibility

If you encounter warnings with Node.js v24:

# Recommended solution: Switch to Node.js v22
nvm install 22
nvm use 22
npm install -g @maria/cli

Installation Issues

# Clear npm cache
npm cache clean --force

# Reinstall
npm uninstall -g @maria/cli
npm install -g @maria/cli

🔗 Links

💬 Support

Email: maria@bonginkan.ai
GitHub Issues: Create an issue