Commerce Ai Agent

CommerceAI Agent is an experimental e-commerce automation application with a FastAPI backend, React dashboard, asynchronous task definitions, integration models, and MCP-oriented agent adapters.

The repository demonstrates architecture and interface concepts. Several screens use sample data, and external services require separate credentials, servers, and validation before they can operate.

Feature status

Feature	Implemented	Mocked	Planned	Evidence
FastAPI application and domain routes	Yes	No	No	src/main.py, src/api/
User, store, product, order, customer, and integration models	Yes	No	No	src/models/, src/schemas/
React administration interface	Yes	Partly	No	frontend/src/; several pages include sample fallback data
PostgreSQL, Redis, RabbitMQ, and Celery topology	Partly	No	No	Docker Compose and task definitions exist; end-to-end operation is not demonstrated by integration tests
JWT-oriented authentication flow	Partly	No	No	Auth routes and helpers exist; production hardening is not established
MCP client and agent adapters	Partly	No	No	Client wrappers exist and require an external MCP server
Inventory, pricing, marketing, customer-service, and email agents	Partly	Partly	No	Adapter classes exist; behavior depends on external MCP functions or LLM services
WooCommerce client	Yes	No	No	src/integrations/woocommerce/client.py
Shopify client	Yes	No	No	src/integrations/shopify/client.py
Stripe and PayPal client wrappers	Yes	No	No	src/integrations/payment/
Amazon and eBay marketplace integration	No	Interface only	Yes	Providers appear in UI/configuration lists; no corresponding client implementation is present
HubSpot and Salesforce integration	No	Interface only	Yes	Listed as providers without client implementations
DHL, UPS, and FedEx integration	No	Interface only	Yes	Listed as providers without client implementations
Autonomous production operation	No	No	Yes	No evidence of a validated autonomous production deployment
Mobile application	No	No	Yes	Roadmap only
ERP integrations	No	No	Yes	Roadmap only

Implemented project surface

• FastAPI route structure for common commerce entities
• SQLAlchemy models and Pydantic schemas
• React pages for products, orders, customers, stores, agents, and integrations
• Celery task modules for pricing, inventory, marketing, email, and customer service workflows
• MCP client abstractions for invoking separately hosted functions
• Client wrappers for selected marketplace and payment providers
• Docker Compose definitions for the application and supporting services

Important limitations

• The repository does not include an MCP server implementing the functions called by the agent adapters.
• UI sample data can be displayed when API queries are unavailable; it must not be interpreted as live store data.
• Listing a provider in the settings interface does not mean its external API is implemented or verified.
• External integrations require provider credentials and have not been certified here for production use.
• The repository does not contain a backend unit or integration test suite.
• No claim is made that the system can run unattended or safely modify a live commerce account.

Architecture

React dashboard
      |
FastAPI routes
      |
SQLAlchemy models ---- PostgreSQL
      |
Celery tasks ---------- RabbitMQ / Redis
      |
Agent adapters -------- external MCP server (not included)
      |
Selected provider client wrappers

Local setup

Prerequisites

• Python 3.9+
• Node.js
• Docker and Docker Compose

Configuration

The application expects environment configuration, but no committed .env.example is present. Review src/core/config.py and create a local .env containing only the values required for the components you intend to evaluate. Do not commit credentials.

Backend

python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
uvicorn src.main:app --reload

Frontend

cd frontend
npm install
npm start

Docker Compose

Docker Compose defines the API, frontend, PostgreSQL, Redis, RabbitMQ, Celery worker, and Flower services:

docker compose up --build

This path requires a valid local .env and should be treated as an experimental development setup.

Technology

• Python, FastAPI, Pydantic, SQLAlchemy
• PostgreSQL, Redis, RabbitMQ, Celery
• React and Material UI
• HTTPX-based MCP client
• Docker Compose

Roadmap

• Complete and test external provider integrations
• Provide an in-repository MCP server or documented compatible implementation
• Replace UI fallback data with explicit demo fixtures
• Add backend unit and integration tests
• Validate background workflows end to end
• Add mobile, ERP, and additional marketplace support only after implementation

License

The repository is licensed under the MIT License.