AutoBazaaar - Autonomous Commerce Agent with Email Automation

A comprehensive AI-powered system combining autonomous e-commerce arbitrage (AutoBazaaar) with intelligent email automation (AgentMail) to discover deals, negotiate purchases, manage listings, and handle customer communications 24/7.

🎯 Overview

AutoBazaaar discovers profitable opportunities across marketplaces, negotiates deals, manages inventory, and lists products across platforms - all automated with AI agents.

AgentMail Integration handles all email communications: buyer inquiries, negotiation threads, and customer support using GPT-4o-mini analysis and response generation.

Key Capabilities

E-Commerce Automation:

🔍 Multi-platform opportunity discovery (Craigslist, Facebook Marketplace, eBay)
💰 AI-powered deal analysis and profit calculation
🤝 Autonomous negotiation with multiple strategies
📦 Inventory management and tracking
📋 Multi-platform listing creation
📊 Real-time metrics and analytics

Email Automation:

📧 24/7 email monitoring via AgentMail
🤖 GPT-4o-mini analysis (intent, sentiment, urgency)
💬 Context-aware automated responses
🔄 Real-time activity tracking
📈 Queue management with Convex database

🚀 Quick Start

Prerequisites

Node.js 20+
npm 9+
API Keys:
- Required: OpenAI, Convex, AgentMail
- Optional: Browser-Use, Hyperspell, Perplexity, Composio, Redis

Installation (10 minutes)

# 1. Clone and install
git clone <repository-url>
cd AgentMail
npm install

# 2. Configure environment
cp .env.example .env
# Edit .env with your API keys

# 3. Setup Convex database
npx convex login
npx convex dev --once
# Copy deployment URL to .env

# 4. Start the system
# Terminal 1: Email orchestrator
npm run orchestrator

# Terminal 2: Backend server (optional - for AutoBazaaar features)
npm run server

# Terminal 3: Dashboard UI
npm run dev

Open http://localhost:3000

📋 Architecture

┌──────────────────────────────────────────────────────┐
│                   AutoBazaaar System                  │
├──────────────────────────────────────────────────────┤
│                                                       │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────┐ │
│  │   Agents    │  │ Integrations │  │  Services  │ │
│  ├─────────────┤  ├──────────────┤  ├────────────┤ │
│  │• Market     │  │• Browser-Use │  │• EventBus  │ │
│  │  Research   │  │• Hyperspell  │  │• Queue Mgr │ │
│  │• Deal       │  │• Perplexity  │  │• Metrics   │ │
│  │  Analyzer   │  │• Composio    │  │• Security  │ │
│  │• Negotiator │  │• OpenAI      │  │            │ │
│  │• Listing    │  │              │  │            │ │
│  └─────────────┘  └──────────────┘  └────────────┘ │
│                                                       │
└──────────────────────────────────────────────────────┘
                         │
                         ▼
┌──────────────────────────────────────────────────────┐
│              AgentMail Email Automation               │
├──────────────────────────────────────────────────────┤
│                                                       │
│  ┌──────────┐    ┌─────────────┐   ┌────────────┐  │
│  │AgentMail │───►│EmailService │──►│EmailProc   │  │
│  │   SDK    │    │ (Queue)     │   │(AI Analyze)│  │
│  └──────────┘    └──────┬──────┘   └────────────┘  │
│                         │                            │
│                         ▼                            │
│                  ┌─────────────┐                     │
│                  │   Convex    │                     │
│                  │  Database   │                     │
│                  └──────┬──────┘                     │
│                         │                            │
│                         ▼                            │
│                  ┌─────────────┐                     │
│                  │  Dashboard  │                     │
│                  │  (Next.js)  │                     │
│                  └─────────────┘                     │
│                                                       │
└──────────────────────────────────────────────────────┘

🔧 Configuration

Required Environment Variables

# Core Services
OPENAI_API_KEY=sk-proj-your_key_here
OPENAI_MODEL=gpt-4o-mini

# Database
CONVEX_URL=https://your-deployment.convex.cloud
NEXT_PUBLIC_CONVEX_URL=https://your-deployment.convex.cloud

# AgentMail Email Automation
AGENTMAIL_API_KEY=am_your_key_here
AUTO_RESPOND=true
EMAIL_POLL_INTERVAL=30

Optional Features

# AutoBazaaar Integrations
BROWSER_USE_API_KEY=your_key_here     # Web scraping
HYPERSPELL_API_KEY=your_key_here      # Memory system
PERPLEXITY_API_KEY=your_key_here      # Market research
COMPOSIO_API_KEY=your_key_here        # Marketplace APIs

# Infrastructure
REDIS_HOST=localhost                   # For queues
REDIS_PORT=6379

See .env.example for complete configuration.

📚 System Components

AutoBazaaar Agents

Located in src/agents/:

MarketResearchAgent - Discovers opportunities across platforms
DealAnalyzerAgent - Analyzes profit potential and risk
NegotiationAgent - Handles buyer/seller negotiations
ListingAgent - Creates and manages multi-platform listings
EmailTemplateEngine - Generates contextual email content
ResponseAnalyzer - Analyzes buyer responses

AgentMail Email System

Located in src/services/:

AgentMailClient - Official AgentMail SDK wrapper
EmailService - Queue management, polling, sending
EmailProcessor - AI analysis pipeline
ResponseGenerator - GPT-4o-mini response generation
NewEmailOrchestrator - System coordinator

Convex Database Schema

AutoBazaaar Tables (11 tables):

opportunities - Discovered deals with analysis
negotiations - Negotiation threads and rounds
inventory - Purchased items
listings - Active platform listings
transactions - Financial records
config, memory, alerts, products, buyerProfiles, negotiationStates

AgentMail Tables (2 tables):

emailQueue - Email processing queue with status
emailActivity - Activity log for dashboard

See convex/schema.ts for complete schema.

🎬 Usage

Running the Email Automation System

# Start orchestrator (processes emails)
npm run orchestrator

# Or directly
npx tsx start-demo.ts

This starts:

✅ Email polling from AgentMail
✅ AI analysis of incoming emails
✅ Automated response generation
✅ Real-time dashboard updates

Running the Full AutoBazaaar System

# Terminal 1: Backend services
npm run server

# Terminal 2: Email orchestrator
npm run orchestrator

# Terminal 3: Dashboard
npm run dev

This enables:

✅ Market opportunity discovery
✅ Deal analysis and negotiation
✅ Listing management
✅ Email automation
✅ Full dashboard with all features

Using Commands (AutoBazaaar)

The dashboard includes a command interface for manual control:

scrape craigslist iphone
analyze deal <opportunity-id>
negotiate <thread-id> start
list product <inventory-id> ebay

📊 Dashboard Features

Access at http://localhost:3000

Metrics Cards

Total profit, revenue, deals completed
Conversion rate, response time
Active listings, emails processed

Email Activity Panel

Real-time email feed (received, analyzed, sent)
Queue statistics (pending, processing, completed)
AI analysis metadata (intent, sentiment, urgency)

Command Interface (AutoBazaaar)

Manual command submission
Command history tracking
Real-time feedback

Scraped Listings (AutoBazaaar)

Discovered opportunities
Profit analysis
Quick actions

Activity Feed

System-wide activity log
Success/error tracking

Transactions Table

Financial history
P&L tracking

🛠️ Development

Project Structure

AgentMail/
├── convex/                          # Convex database
│   ├── schema.ts                    # All 13 tables
│   ├── emails.ts                    # Email queue functions
│   ├── listings.ts                  # Listing functions
│   └── commands.ts                  # Command functions
│
├── src/
│   ├── agents/                      # AutoBazaaar AI agents
│   │   ├── MarketResearchAgent.ts
│   │   ├── DealAnalyzerAgent.ts
│   │   ├── NegotiationAgent.ts
│   │   └── ListingAgent.ts
│   │
│   ├── services/                    # AgentMail services
│   │   ├── AgentMailClient.ts
│   │   ├── EmailService.ts
│   │   ├── EmailProcessor.ts
│   │   └── ResponseGenerator.ts
│   │
│   ├── integrations/                # External APIs
│   │   ├── BrowserUseIntegration.ts
│   │   ├── HyperspellIntegration.ts
│   │   ├── PerplexityIntegration.ts
│   │   └── ComposioIntegration.ts
│   │
│   ├── core/                        # Infrastructure
│   │   ├── events/EventBus.ts
│   │   ├── queue/QueueManager.ts
│   │   ├── agents/AgentRegistry.ts
│   │   └── command/CommandExecutor.ts
│   │
│   ├── workflows/
│   │   └── NewEmailOrchestrator.ts  # Email orchestration
│   │
│   ├── server/                      # Backend API
│   │   ├── index.ts
│   │   └── websocket.ts
│   │
│   └── ui/                          # Next.js dashboard
│       ├── pages/index.tsx
│       └── components/
│
├── start-demo.ts                    # Email orchestrator entry
├── AGENTMAIL_INTEGRATION.md         # Email system docs
├── DEVELOPMENT.md                   # Development guide
├── PROJECT_STATUS.md                # AutoBazaaar status
└── README.md

Available Scripts

npm run dev           # Start dashboard (localhost:3000)
npm run orchestrator  # Start email processor
npm run server        # Start backend API (AutoBazaaar)
npm run demo          # Run demo scenario
npm run type-check    # TypeScript checking
npm run lint          # ESLint
npm run test          # Jest tests

Key Features by Script

npm run orchestrator → AgentMail email automation only npm run server → AutoBazaaar backend (EventBus, Redis, agents) npm run dev → Dashboard UI (shows all features)

📖 Documentation

AGENTMAIL_INTEGRATION.md - Complete AgentMail guide
- Email processing pipeline
- API reference
- Troubleshooting
- Performance tips
DEVELOPMENT.md - Development workflow
- Setup instructions
- Code structure
- Testing guide
- Deployment
PROJECT_STATUS.md - AutoBazaaar status
- Implementation progress
- Known issues
- Configuration requirements

🔒 Security

✅ API keys in environment variables only
✅ Self-email loop prevention
✅ Input validation and sanitization
✅ Rate limiting support
✅ Error handling with retry logic
✅ Webhook signature validation (optional)

🚀 Deployment

Option 1: Docker (Recommended)

docker-compose up -d

Includes:

AutoBazaaar backend
Redis
Dashboard UI

Option 2: Manual Deployment

See DEVELOPMENT.md for:

PM2 process management
Vercel deployment (UI only)
Railway/Render deployment

Production Checklist

All API keys configured in .env
Convex deployed (npx convex deploy --prod)
Redis running (if using AutoBazaaar)
Webhook URL configured (for instant email delivery)
Environment set to production
Monitoring configured (Sentry optional)

🤝 Contributing

Create feature branch
Make changes
Run npm run type-check and npm run lint
Test thoroughly
Create pull request

See DEVELOPMENT.md for detailed guidelines.

📝 License

MIT License

🙏 Built With

Core:

AgentMail - Email infrastructure & SDK
Convex - Real-time serverless database
OpenAI - GPT-4o-mini AI
Next.js - Dashboard framework

Integrations (Optional):

Browser-Use - Web automation
Hyperspell - Memory system
Perplexity - Market intelligence
Composio - Marketplace APIs

🎯 What Makes This Special

Unified System

Unlike separate tools, AutoBazaaar + AgentMail work together:

Opportunities discovered → Email negotiations handled automatically
Buyer inquiries → AI analyzes and responds with context
Listings created → Customer emails managed 24/7

Database as Source of Truth

Convex database shared across all processes
Real-time sync between backend, orchestrator, and dashboard
Persistent state survives restarts
Scalable to multiple instances

Production Ready

Error handling with retries
Comprehensive logging
Metrics and monitoring
Docker support
Complete documentation

Version: 3.0.0 (AutoBazaaar + AgentMail merged) Last Updated: 2025-01-11

Questions? See AGENTMAIL_INTEGRATION.md or DEVELOPMENT.md

Name		Name	Last commit message	Last commit date
Latest commit History 43 Commits
convex		convex
python_bridge		python_bridge
screenshots		screenshots
src		src
.env.example		.env.example
.gitignore		.gitignore
AGENTMAIL_INTEGRATION.md		AGENTMAIL_INTEGRATION.md
AutoBazaaar_Complete_Technical_PRD.md		AutoBazaaar_Complete_Technical_PRD.md
BROWSER_USE_COMPLETE_REPORT.md		BROWSER_USE_COMPLETE_REPORT.md
BROWSER_USE_INTEGRATION.md		BROWSER_USE_INTEGRATION.md
CONVEX_INTEGRATION_COMPLETE.md		CONVEX_INTEGRATION_COMPLETE.md
CONVEX_RUNNING_STATUS.md		CONVEX_RUNNING_STATUS.md
CONVEX_SETUP.md		CONVEX_SETUP.md
CONVEX_TABLES_VERIFICATION.md		CONVEX_TABLES_VERIFICATION.md
CONVEX_VERIFICATION_COMPLETE.md		CONVEX_VERIFICATION_COMPLETE.md
DEVELOPMENT.md		DEVELOPMENT.md
Dockerfile		Dockerfile
EXAMPLE_USAGE.md		EXAMPLE_USAGE.md
FIXES_APPLIED.md		FIXES_APPLIED.md
HOW_IT_WORKS_NOW.md		HOW_IT_WORKS_NOW.md
IMPLEMENTATION_STATUS.md		IMPLEMENTATION_STATUS.md
MULTI_MARKETPLACE_SEARCH.md		MULTI_MARKETPLACE_SEARCH.md
PRODUCTION_READINESS_ASSESSMENT.md		PRODUCTION_READINESS_ASSESSMENT.md
PROJECT_STATUS.md		PROJECT_STATUS.md
PROJECT_SUBMISSION_REPORT.md		PROJECT_SUBMISSION_REPORT.md
QUICK_START_PRODUCTION.md		QUICK_START_PRODUCTION.md
README.md		README.md
REALTIME_PROGRESS.md		REALTIME_PROGRESS.md
REAL_BROWSER_USE_ENABLED.md		REAL_BROWSER_USE_ENABLED.md
REAL_SCRAPED_LISTINGS.md		REAL_SCRAPED_LISTINGS.md
SCREENSHOT_FLOW.md		SCREENSHOT_FLOW.md
SCREENSHOT_SCRAPER_INTEGRATION.md		SCREENSHOT_SCRAPER_INTEGRATION.md
SERVICES_RUNNING.md		SERVICES_RUNNING.md
SETUP_COMPLETE.md		SETUP_COMPLETE.md
SIMULATION_VS_REAL.md		SIMULATION_VS_REAL.md
TEST_CONVEX_TABLES.md		TEST_CONVEX_TABLES.md
TEST_RESULTS.md		TEST_RESULTS.md
UI_COMPLETE.md		UI_COMPLETE.md
UI_TEST_RESULTS.md		UI_TEST_RESULTS.md
WEB_DOMAIN_SCRAPER.md		WEB_DOMAIN_SCRAPER.md
WORKING_STATUS.md		WORKING_STATUS.md
browser-use-llms.txt		browser-use-llms.txt
convex.json		convex.json
docker-compose.yml		docker-compose.yml
ebay_screenshot.jpg		ebay_screenshot.jpg
env.config		env.config
package-lock.json		package-lock.json
package.json		package.json
profitpilot_prd.md		profitpilot_prd.md
profitpilot_prd.md.pdf		profitpilot_prd.md.pdf
quick-convex-setup.sh		quick-convex-setup.sh
requirements.txt		requirements.txt
run.sh		run.sh
screenshot_ebay_products_simple.ts		screenshot_ebay_products_simple.ts
search_and_screenshot_ebay.ts		search_and_screenshot_ebay.ts
search_and_screenshot_products.ts		search_and_screenshot_products.ts
setup-convex.sh		setup-convex.sh
start-demo.ts		start-demo.ts
start_all_services.sh		start_all_services.sh
start_app.sh		start_app.sh
start_browser_bridge.sh		start_browser_bridge.sh
stop_all_services.sh		stop_all_services.sh
take_ebay_screenshot.ts		take_ebay_screenshot.ts
test-insert-data.sh		test-insert-data.sh
test_agentmail_scrape.ts		test_agentmail_scrape.ts
test_all_features.sh		test_all_features.sh
test_browser_use.ts		test_browser_use.ts
test_comprehensive.ts		test_comprehensive.ts
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

AutoBazaaar - Autonomous Commerce Agent with Email Automation

🎯 Overview

Key Capabilities

🚀 Quick Start

Prerequisites

Installation (10 minutes)

📋 Architecture

🔧 Configuration

Required Environment Variables

Optional Features

📚 System Components

AutoBazaaar Agents

AgentMail Email System

Convex Database Schema

🎬 Usage

Running the Email Automation System

Running the Full AutoBazaaar System

Using Commands (AutoBazaaar)

📊 Dashboard Features

Metrics Cards

Email Activity Panel

Command Interface (AutoBazaaar)

Scraped Listings (AutoBazaaar)

Activity Feed

Transactions Table

🛠️ Development

Project Structure

Available Scripts

Key Features by Script

📖 Documentation

🔒 Security

🚀 Deployment

Option 1: Docker (Recommended)

Option 2: Manual Deployment

Production Checklist

🤝 Contributing

📝 License

🙏 Built With

🎯 What Makes This Special

Unified System

Database as Source of Truth

Production Ready

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages