Skip to content
AndreZ1971Public

About

Autonomous AI system for WooCommerce shops — analyses, optimises and grows your shop 24/7. 4 agentic loops, 50+ tools, 12 industry specialisations. Self-hostable.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

701 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 A.R.I. - Artificial Retail Intelligence

🇩🇪 Deutsche Version

Version Tests ML Integration Design System License

The Digital Employee for Your Online Store

A system that analyzes, optimizes, and grows your WooCommerce shop –
without you having to deal with technology, servers, or configuration.

🚀 Installation • 📚 Documentation • 💬 Support • 🔧 Features


📋 Table of Contents


🎯 The Vision

Shop owners spend most of their time on tasks that are repetitive and bring little joy:

  • ✍️ Writing product descriptions
  • 📱 Creating social media posts
  • 📊 Analyzing data (which product is really performing well?)
  • 📧 Writing emails (follow-ups, upsells, welcome series)
  • 📈 Planning and implementing campaigns
  • 🔍 Recognizing trends before the competition does

A.R.I. gives you this time back.

⚠️ The Problem

Do You Know This Situation?

Your shop is thriving, but you're stuck. Conversion could be better. Customer communication is chaotic. Your bestseller products don't know they're bestsellers. And somehow you lack the capacity to reach the next growth level.

All the work is on you. You are the bottleneck.

✅ The Solution

A.R.I. helps you with the operational work of your shop. Simple. Intelligent. Around the clock.

📦 Product Management

New products? A.R.I. analyzes trends, writes SEO texts, generates images, organizes everything – ready to sell. You approve, done.

📊 Real Insights

No more dashboard paralysis. A.R.I. tells you concretely: "Your top product has an image problem – here are 3 concrete measures." You make the decision, A.R.I. implements it.

📧 Intelligent Customer Relationships

Abandoned carts? Customers who haven't bought anything in a long time? A.R.I. knows them and creates personalized message drafts – you review and approve. That simple.

📱 Visible Everywhere

Your shop is on Facebook, Instagram, LinkedIn, email, and more. A.R.I. generates smart content for 5+ platforms, scheduling posts at the right time with images and texts that work.

🔄 Constantly Getting Better

44 specialized processes run in the background. Your shop gets better every day – without your intervention.

🎁 What Changes for You?

Area Improvement
⏰ Time You get your time back – 5–10 hours per week less admin work
💰 Numbers Conversion increases, customers are better served, repeat purchases rise
📊 Insights You understand your business better – clear, actionable insights instead of data garbage
🚀 Scaling You can scale – without hiring more people

Concretely Implemented Through

  • ✅ Optimized product texts (SEO-optimized, sales-promoting)
  • ✅ AI-generated product images (DALL-E integration)
  • ✅ Real-time analytics with real WooCommerce data (no mock data)
  • ✅ Email automation (carts, welcome series, reactivation)
  • ✅ Social media posts (LinkedIn, Facebook, Twitter, YouTube with API publishing; Instagram & TikTok with AI text generation via copy-to-clipboard)
  • ✅ Global Design Token System with Dark Mode
  • ✅ 8-language support (DE, EN, FR, ES, IT, PT, NL, PL)
  • ✅ Specialization-aware AI personalization
  • ✅ Multi-source trend analysis (Google Trends + Reddit OAuth)
  • ✅ Percentage-based price suggestions with deterministic calculation
  • ✅ Manual validation of AI suggestions before adoption
  • ✅ Complete WooCommerce integration without placeholders
  • ✅ Support tickets with HTML sanitization
  • ✅ Product idea scoring without random values

🚀 Features

🤖 Agentic Loop Framework

4 specialized loop types work autonomously in the background:

1. Anomaly Detection Loop 🚨

  • Automatically detects payment anomalies
  • Types: failed_payment, unusual_amount, repeated_attempts, high_risk
  • Real-time monitoring & alerting

2. Product Performance Loop 📈

  • Automatically A/B tests product attributes
  • Enhances: Price (-10%), title (+Bestseller), description (+Benefits)
  • Continuous conversion improvement

3. Payment Recovery Loop 💳

  • Attempts failed orders with different strategies
  • Strategies: Retry, Discount, Alternative Payment, Contact
  • Success Rate: up to 60% with contact strategy

4. Analytics Insights Loop 📊

  • Automatically generates dashboard insights
  • Detects anomalies and trends
  • Delivers recommendations for actions

🛡️ Enterprise-Grade Error Handling

Feature Description
Circuit Breaker Protection against cascade failures (CLOSED → OPEN → HALF_OPEN)
Retry Strategies Exponential backoff with jitter
Dead Letter Queue Automatic recovery of failed jobs
Multi-Channel Alerting Email, Slack, Webhooks

🔧 51+ Intelligent Tools

Important: All tools work assistively – drafts, analyses, and hints are generated; approvals and live changes remain always with you.

  • ✅ Optimized product texts (SEO-optimized, sales-promoting)
  • ✅ AI-generated product images (DALL-E integration)
  • ✅ Real-time analytics with real recommendations
  • ✅ Email automation (carts, welcome series, reactivation)
  • ✅ Social media posts (6 platforms)
  • ✅ Anomaly detection (problems are reported to you before they become critical)

⚙️ Technology

Backend Stack

Technology Version Usage
Node.js 18+ Server Runtime
Fastify 5.2.1 REST API Framework
TypeScript 5.8.3 Type-Safe Development
OpenAI SDK Latest GPT-4, DALL-E, Embeddings
Vitest 2.1.8 Testing Framework

Frontend Stack

Technology Version Usage
React 18.3.1 UI Framework
Vite 6.0.5 Build Tool
Shadcn/ui Latest Component Library
Tailwind CSS 3.4.17 Styling
Framer Motion Latest Animations

🤖 AI & ML Integration

  • GPT-4: Planning Engine, Content Generation
  • GPT-4o-mini: Fast analyses, user-favor detection
  • DALL-E: Automatic image generation
  • Embeddings: Semantic search & matching
  • Custom ML: Trend analysis, sentiment detection, pattern recognition

🧠 AI Agent System

Component Description
Planner GPT-4 planning engine for multi-step action plans
Memory Conversation context management (128k token window)
Tools 51+ specialized tools for WooCommerce, WordPress, OpenAI
Scheduler Cron-based automation for 44 job types

🛡️ Error Handling & Resilience

  • Circuit Breaker: Failure → OPEN → HALF_OPEN → Recovery Flow
  • Retry Logic: Exponential backoff with jitter
  • Dead Letter Queue: Disk-based persistence of failed jobs
  • Alerting: Email/Slack/Webhook multi-channel notifications

🔧 Tool Overview

📊 Analytics (13 Tools)

  • Shop Metrics: Live KPIs (revenue, orders, conversion)
  • Conversion Analysis: Funnel analysis with drop-off detection
  • Feedback Analysis: Review & ticket sentiment analysis
  • Trend Analysis: AI-powered trend detection
  • Real Analytics: Real-time dashboard
  • Shop Health Report: 360° shop audit
  • Premium/Standard/Mini Audit: Various audit depths

📦 Product Management (8 Tools)

  • Product Analyzer: ML-based product optimization
  • Auto Product Creator: AI content generation
  • Categories Manager: Intelligent category management
  • Product Bundles: Bundle creation with AI suggestions
  • Freebies Creator: Automatic free products
  • Notes Feature: Storage location tracking with autosave

💳 Payment & Finances (13 Tools)

  • Payment Verifier: ML-based transaction verification
  • Payment Tester: Automated payment flow tests
  • Payment Emergency: AI emergency analysis with GPT-4o-mini
  • Payment Expansion: AI expansion planning
  • Payment Success: Success rate tracking
  • +8 more payment tools with ML integration

📧 Marketing & Content (10 Tools)

  • AI Email Generator: Personalized email drafts
  • Social Media Poster: Multi-platform upload
    • ✅ Facebook: Fully functional
    • ✅ YouTube: Functional (Daily upload limit: 6 videos/day)
    • ✅ LinkedIn: API integration ready (requires valid credentials)
    • ⚠️ Twitter/X: Requires paid API credit
    • ⚠️ Instagram: Requires Meta Business Review
    • ⚠️ TikTok: Requires TikTok Developer Account
  • Blogpost Generator: SEO-optimized blog posts
  • Image Analyzer: AI image quality check
  • German Content Generator: German marketing texts
  • +5 more content tools

🧠 Advanced AI (9 Tools)

  • Context Generator: AI prompt optimization
  • Memory System: Persistent AI context
  • System Health: Real-time monitoring
  • User Management: Customer intelligence with ML personalization
  • Real Web Analytics: Multi-source trend analysis
  • +4 more advanced tools

💡 Important: All tools work assistively – approvals always require your click!

📊 Status & Roadmap

✅ Current Status

Metric Status
Version 7.4.0 – Production-Ready
Tests 350+ ✅
Workflows 50+ automated jobs
Languages German & English (+ 6 more)
Stable since February 2026

🤖 ML/AI Integration Status

Category Tools ML/AI Status
Analytics 13 🟢 13/13 100%
Products 8 🟢 8/8 100%
Payments 13 🟢 13/13 100%
Marketing 10 🟢 10/10 100%
Advanced 9 🟢 9/9 100%
TOTAL 53 🟢 53/53 100%

🔭 Roadmap (no database required)

  • Lightweight knowledge base: FAQs/answer snippets as JSON/YAML in-repo (git versioned); vector store only as an optional, later extension.
  • Light feedback loop: thumbs up/down in the frontend, stored as small JSON/CSV logs with rotation; analyze offline when needed.
  • More live-data intents: revenue today, top sellers, low stock via existing WooCommerce APIs, no persistence.
  • Tests & observability: golden chat tests (Vitest/Playwright), simple request/fallback logs with rotation; metrics derivable from logs.
  • Feature flags without DB: env vars or small config files for new intents/prompts; toggled per deploy.

🆕 Recent Updates (January 8, 2026)

✅ Configuration System:

  • Multi-path fallback loader for connection.json
  • Centralized credentials management (no .env API keys)
  • Support for dev, production, and CI/CD environments
  • Detailed fallback logging for debugging

✅ Reddit Integration:

  • Genuine OAuth 2.0 with Client Credentials Flow
  • Real customer discussions and sentiment
  • Async with caching to prevent rate limits
  • Fallback support in trend aggregation

✅ Price Intelligence:

  • Percentage-based limits (+20% / -15% default)
  • Dynamic fallback scaling (30-70% range)
  • Double validation (frontend + backend)
  • Real-time price preview in UI

✅ UI/UX Improvements:

  • Dark glass theme with high contrast
  • Improved error messages and logging
  • Manual validation of AI suggestions
  • Better accessibility (WCAG 2.1 AA)

⚖️ Open-Source Notice & Specialization Model

This section is a short summary. The legally binding terms are defined in LICENSE.

Open-source base

  • The source code is licensed under GNU AGPL v3 (with additional terms under AGPL Section 7).
  • Commercial and non-commercial use of the base model is allowed if all AGPL obligations are fulfilled.

Specialization model

  • Signed specialization files (.ari-spec) are proprietary content and are not part of the AGPL code grant.
  • Signature verification is a core integrity mechanism and must not be removed, disabled, or bypassed.
  • The embedded public key in the verifier must not be replaced.
  • SKIP_SIGNATURE_VERIFICATION=true is not allowed in production environments.

In short

  • You may use, modify, and redistribute the open-source code under AGPL obligations.
  • You may not redistribute, resell, or reverse-engineer proprietary signed specializations.

🛡️ Security & Compliance

🔐 Authentication

Service Method
WooCommerce OAuth 1.0a
WordPress Basic Auth with Application Passwords
OpenAI API Key Authentication

🔒 Privacy & Data Protection

  • ✅ GDPR-compliant: All tools with privacy notices
  • ✅ OpenAI: 30-day retention, RAM-only processing
  • ✅ No cookies: Session-based authentication
  • ✅ Encryption: AES-256-GCM for sensitive data


📚 Documentation

Document Description Link
📖 User Manual Complete user guide docs/english/USER_MANUAL.md
🔧 Tool Documentation All 53 tools in detail docs/english/TOOLS_DOCUMENTATION.md
💡 User FAQ Frequently asked questions for shop owners docs/english/USER_FAQ.md
🛠️ Developer FAQ Technical FAQ for developers docs/english/DEVELOPER_FAQ.md
🛡️ Security Security & best practices docs/english/SECURITY.md
🧪 Testing Test coverage & quality docs/english/TESTING.md
🚀 Deployment Server setup & installation docs/english/DEPLOYMENT_GUIDE.md

💬 Support


📄 License

GNU AGPL v3 with additional terms - see LICENSE for details.


🙏 Credits

Developed with ❤️ by André Zabel (@AndreZ1971)

Powered by:

OpenAI WooCommerce WordPress React Vite Fastify Docker


🎯 Built for shop owners who want to use their time for the important decisions.

🚀 Installation • 📚 Documentation • 💬 Support

About

Autonomous AI system for WooCommerce shops — analyses, optimises and grows your shop 24/7. 4 agentic loops, 50+ tools, 12 industry specialisations. Self-hostable.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages