GitHub - colddsam/coldscout: Cold Scout — Autonomous AI-powered B2B lead generation SaaS. Discovers local businesses via Google Places, qualifies them with Groq Llama 3, and sends hyper-personalized cold email campaigns. Built with FastAPI, React 19, PostgreSQL, Supabase Auth, and Razorpay billing

COLD SCOUT AI LEAD GENERATION SYSTEM

📖 Table of Contents

Section	Description
Brand Identity	Vision, mission, and design philosophy
Project Overview	What Cold Scout does and why
Monorepo Structure	How the repo is organized
System Architecture	Full pipeline and data flow diagrams
Tech Stack	Complete technology inventory
Key Features	Platform capabilities overview
Pipeline Stages	Step-by-step AI automation flow
User Roles & Plans	RBAC and billing tier details
Quick Start	Get running in under 10 minutes
Environment Variables	All configuration parameters
Deployment	Production deployment guide
Testing	Test suite overview
Contributing	How to contribute

🏛 Brand Identity

Vision

To completely automate the B2B sales development lifecycle with intelligent, autonomous AI agents — eliminating the friction between prospect discovery and meaningful engagement.

Mission

Empowering high-performance B2B sales teams and freelancers with a tireless, 24/7 AI-driven outreach pipeline that discovers, qualifies, and engages ideal prospects at scale — without human intervention.

Design Philosophy

  ┌─────────────────────────────────────────────────────┐
  │  Visual Identity: Monochromatic Elegance             │
  │                                                      │
  │  Primary  ██████  #000000  Black — Authority          │
  │  Surface  ██████  #FFFFFF  White  — Clarity           │
  │  Accent   ██████  #888888  Gray   — Sophistication    │
  │                                                      │
  │  UX: Glassmorphism · Micro-animations · Responsive  │
  └─────────────────────────────────────────────────────┘

🚀 Project Overview

Cold Scout is an enterprise-grade, end-to-end B2B lead generation platform. The system functions as a fully autonomous Sales Development Representative (SDR), capable of:

Discovering local businesses via Google Places API with international multi-country targeting and paginated results (up to 60 per location)
Scraping company websites with Playwright to extract contact signals (email, phone, social)
Qualifying leads using Groq AI (Llama 3) against configurable Ideal Customer Profiles (ICPs)
Personalizing outreach campaigns with AI-generated emails, PDF proposals, and XLSX reports
Sending hyper-personalized cold emails via Brevo SMTP with built-in throttling
Tracking opens, clicks, and replies — auto-classifying intent (positive/negative/OOO)
Following up with automated multi-step sequences for non-responsive prospects
Reporting daily analytics reports to admin email with full conversion funnel metrics

📁 Monorepo Structure

coldscout/                          ← Monorepo Root
│
├── 📂 backend/                     ← FastAPI Application (Python 3.11+)
│   ├── app/
│   │   ├── api/v1/                 ← REST API routes (auth, leads, billing, ...)
│   │   ├── core/                   ← Database, scheduler, locks, security
│   │   ├── models/                 ← SQLAlchemy ORM models
│   │   ├── modules/                ← Business logic (discovery, AI, email, ...)
│   │   ├── schemas/                ← Pydantic request/response schemas
│   │   └── tasks/                  ← Background pipeline tasks
│   ├── migrations/                 ← Alembic database migrations
│   ├── scripts/                    ← Admin & setup utility scripts
│   ├── tests/                      ← Pytest test suite (10 test files)
│   ├── Dockerfile                  ← Container image definition
│   ├── docker-compose.yml          ← Local stack orchestration
│   ├── requirements.txt            ← Python dependencies
│   ├── README.md                   ← Backend documentation
│   └── DEPLOYMENT.md               ← Backend deployment guide
│
├── 📂 frontend/                    ← React 19 Dashboard (Vite + TypeScript)
│   ├── src/
│   │   ├── components/             ← Reusable UI components
│   │   ├── hooks/                  ← Custom React hooks
│   │   ├── lib/                    ← Utilities, API client, Supabase
│   │   └── pages/                  ← Route-level page components (24 pages)
│   ├── server/                     ← Dev-only Node.js proxy server
│   ├── public/                     ← Static assets
│   ├── nginx.conf                  ← Production nginx configuration
│   ├── vercel.json                 ← Vercel deployment configuration
│   ├── Dockerfile                  ← Frontend container image
│   ├── README.md                   ← Frontend documentation
│   └── DEPLOYMENT.md               ← Frontend deployment guide
│
├── 📂 .github/
│   └── workflows/
│       ├── ci.yml                  ← CI: tests, lint, build checks
│       ├── pipeline-health-check.yml ← Daily health monitoring
│       └── setup_cronjob.yml       ← Uptime cron registration
│
├── 📂 docs/                        ← Additional documentation
├── docker-compose.yml              ← Full-stack local orchestration
├── .env.example                    ← Environment template (42 variables)
├── README.md                       ← This file
└── DEPLOYMENT.md                   ← Production deployment master guide

🏗 System Architecture

High-Level Overview

graph TB
    subgraph "👤 Users"
        FR[Freelancer<br/>Free / Pro / Enterprise]
        CL[Client<br/>View-Only Access]
    end

    subgraph "🌐 Frontend — React 19 + Vite"
        LP[Landing Page]
        AUTH[Auth Pages<br/>Login / SignUp / OAuth]
        DASH[Dashboard<br/>Overview / Leads / Campaigns]
        SCHED[Scheduler Control]
        BILL[Billing / Upgrade]
    end

    subgraph "🔐 Auth Layer"
        SB[Supabase Auth<br/>PKCE · OAuth · JWT ES256]
    end

    subgraph "⚙️ Backend — FastAPI"
        direction TB
        API[REST API<br/>/api/v1/...]
        SCHED_CORE[APScheduler<br/>Async Task Engine]
        JM[Job Manager<br/>jobs_config.json]
    end

    subgraph "🗄️ Data Layer"
        DB[(PostgreSQL<br/>via Supabase)]
    end

    subgraph "🤖 Autonomous Pipeline"
        direction LR
        D[1. Discovery<br/>Google Places API]
        S[2. Scraping<br/>Playwright]
        Q[3. Qualification<br/>Groq Llama 3]
        P[4. Personalization<br/>AI Email + PDF]
        O[5. Outreach<br/>Brevo SMTP]
        T[6. Tracking<br/>Pixel + IMAP]
        F[7. Follow-up<br/>Auto Sequences]
        R[8. Reporting<br/>Daily Analytics]
    end

    subgraph "📡 External Services"
        GROQ[Groq AI]
        GPLACES[Google Places]
        BREVO[Brevo SMTP]
        TG[Telegram Bot]
    end

    FR --> LP
    CL --> LP
    LP --> AUTH
    AUTH --> SB
    SB --> DASH
    DASH --> API
    SCHED --> API
    BILL --> API
    API --> DB
    API --> SCHED_CORE
    SCHED_CORE --> JM
    SCHED_CORE --> D
    D --> S --> Q --> P --> O --> T --> F --> R
    D --> GPLACES
    Q --> GROQ
    O --> BREVO
    R --> TG

Autonomous Pipeline Flow

sequenceDiagram
    participant Cron as ⏰ Scheduler
    participant GP as 🗺 Google Places
    participant PW as 🌐 Playwright
    participant Groq as 🤖 Groq AI
    participant DB as 🗄️ PostgreSQL
    participant SMTP as 📧 Brevo SMTP
    participant IMAP as 📥 IMAP
    participant TG as 📲 Telegram

    Cron->>GP: run_discovery_stage()
    GP-->>DB: INSERT leads (deduplicated)
    TG-->>TG: Alert: N leads discovered

    Cron->>PW: run_qualification_stage()
    PW-->>DB: UPDATE website_content, email, phone
    Note over PW,DB: Scrapes contact signals

    Cron->>Groq: qualify_lead(lead)
    Groq-->>DB: UPDATE qualification_score, status
    Note over Groq,DB: score ≥ 50 → qualified

    Cron->>Groq: generate_email(lead)
    Groq-->>DB: UPDATE email_body, pdf_proposal
    Note over Groq,DB: Hyper-personalized content

    Cron->>SMTP: send_email(lead)
    SMTP-->>DB: UPDATE status = sent
    Note over SMTP,DB: Tracking pixel embedded

    IMAP->>DB: fetch_recent_replies()
    Note over IMAP,DB: Auto-classify intent

    Cron->>TG: send_daily_report_email()

Database Entity Relationships

erDiagram
    User {
        uuid id PK
        string email
        string role
        string plan
        boolean is_active
    }
    Lead {
        uuid id PK
        string place_id
        string business_name
        string email
        string phone
        string country
        string country_code
        string region
        string city
        string sub_area
        float qualification_score
        string status
        string demo_site_status
        text generated_demo_html
        int demo_view_count
        datetime discovered_at
    }
    Campaign {
        uuid id PK
        string name
        string status
        int leads_discovered
        int leads_qualified
        int emails_sent
    }
    EmailOutreach {
        uuid id PK
        uuid lead_id FK
        uuid campaign_id FK
        string status
        string subject
        text body_html
        datetime sent_at
    }
    EmailEvent {
        uuid id PK
        uuid outreach_id FK
        string event_type
        datetime occurred_at
    }
    Subscription {
        uuid id PK
        uuid user_id FK
        string plan
        string razorpay_sub_id
        datetime expires_at
    }
    DailyReport {
        uuid id PK
        date report_date
        int discovered
        int qualified
        int sent
        int opened
        int replied
    }

    User ||--o{ Subscription : "has"
    Campaign ||--o{ Lead : "discovers"
    Lead ||--o{ EmailOutreach : "receives"
    EmailOutreach ||--o{ EmailEvent : "generates"

🛠 Tech Stack

Backend

Layer	Technology	Purpose
API Framework	FastAPI 0.115	Async REST API with OpenAPI docs
Runtime	Python 3.11+	Core language
Database ORM	SQLAlchemy 2.0 (async)	Database abstraction layer
Database Driver	asyncpg 0.30	Async PostgreSQL driver
Migrations	Alembic 1.13	Schema version control
Scheduler	APScheduler 3.10	Cron/interval background tasks
AI Engine	Groq SDK (Llama 3)	Lead qualification + email generation
AI Demo Builder	Google Gemini 1.5 Flash	Interactive landing page generation
Web Scraping	Playwright 1.48	Headless browser automation
HTTP Client	HTTPX 0.27	Async HTTP requests
HTML Parsing	BeautifulSoup4	Website content extraction
Email Sending	aiosmtplib 3.0	Async SMTP delivery
Email Templates	Jinja2 3.1	HTML email rendering
PDF Generation	ReportLab + WeasyPrint	Proposal document creation
Excel Reports	openpyxl 3.1	Analytics spreadsheet export
Authentication	Supabase + PyJWT	ES256 JWT verification
Payment	Razorpay 1.4	Subscription billing
Notifications	python-telegram-bot 21.6	Real-time Telegram alerts
Rate Limiting	SlowAPI 0.1	API endpoint throttling
Retry Logic	Tenacity 9.0	Resilient external API calls
Logging	Loguru 0.7	Structured application logging
Validation	Pydantic v2	Request/response schemas
Containerization	Docker + Docker Compose	Environment reproducibility

Frontend

Layer	Technology	Purpose
UI Framework	React 19	Component-based UI
Language	TypeScript 5.9	Type-safe development
Build Tool	Vite 8	Ultra-fast dev server & bundler
Styling	TailwindCSS 3.4	Utility-first CSS
Routing	React Router 7	Client-side navigation
Data Fetching	TanStack Query v5	Server state management + caching
HTTP Client	Axios	API communication
Animation	Framer Motion 12	Micro-animations
Charts	Recharts 3	Analytics visualizations
Auth	Supabase JS SDK 2	Authentication provider
Code Editor	Monaco Editor	JSON config editing
Icons	Lucide React	Icon system
Virtualization	react-window	Large list rendering
Notifications	react-hot-toast	Toast notifications
Dev Proxy	Node.js (Express)	X-API-Key injection

✨ Key Features

🔍 Organic Lead Discovery

Programmatically queries Google Places API with international multi-country targeting
Full location hierarchy: Country → Region → City → Sub-Area (neighborhood/district)
regionCode and locationBias for precise geographic scoping across countries
Paginated results (up to 60 per location via nextPageToken)
Structured geo extraction from addressComponents (country, region, postal code, lat/lng)
Intelligent deduplication via place_id and email matching — never re-discovers known leads
SearchHistory model prevents redundant API spend within cooling periods
Configurable via DISCOVERY_COUNTRY_FOCUS, DISCOVERY_DEPTH, DISCOVERY_TARGET_COUNT, DISCOVERY_MAX_PAGES

🤖 AI-Powered Qualification

Playwright headless browser scrapes company websites for contact signals
Extracts: emails, phone numbers, social profiles (LinkedIn, Twitter, Instagram, Facebook)
Groq AI (Llama 3.1) scores leads 0–100 against configurable ICP criteria
Qualification status machine: discovered → qualified → phone_qualified → rejected
Score ≥ 50 with email → qualified (automated email sequence)
Score ≥ 50 with phone only → phone_qualified (manual WhatsApp alert)

✉️ Hyper-Personalized Outreach

AI generates unique email for every qualified lead based on their website analysis
Embeds tracking pixel (1×1 transparent PNG) for open detection
Attaches PDF proposal and XLSX data package per lead
Brevo SMTP delivery with configurable throttle (EMAIL_SEND_INTERVAL_SECONDS)
Jinja2 HTML templates for responsive, branded emails

📊 Real-Time Dashboard

Live pipeline monitoring across all 5 stages
Full lead lifecycle management with qualifier score display
Campaign creation, pausing, and management
Scheduler override — manually trigger any pipeline stage
Analytics with funnel charts, bar charts, and conversion metrics
Inbox — auto-classified replies by intent (positive / negative / OOO)
Pipeline Log UI — Real-time execution logs for every job stage (requires Redis)
Booking Redirects — Native /book/{username} clean links for prospect scheduling

🔐 Enterprise Authentication

Supabase Auth with PKCE flow for OAuth providers
Supported providers: Email/password, Google, GitHub, Facebook, LinkedIn
Backend validates JWT with ES256 via Supabase JWKS endpoint
Role-based access: freelancer (full access) vs client (view-only)
Plan gating: Free / Pro / Enterprise tiers for freelancers
Session expiry modal with graceful re-authentication

💳 Razorpay Billing

INR-denominated subscription plans (Free / Pro / Enterprise)
Razorpay order creation → payment verification → subscription activation
Webhook handler for payment events with HMAC signature validation
Scheduled billing task for subscription expiry management
Upgrade modal with plan comparison table

📲 Smart Notifications

Telegram bot alerts for: new lead discoveries, qualified leads, daily reports, system errors
WhatsApp alerts (via CallMeBot) for phone-qualified leads requiring manual action
GitHub Actions daily health check with automated status reporting

🌐 AI Demo Website Builder

Generates interactive, brand-personalized landing pages for leads without a website
Two-stage AI pipeline: Groq extracts brand blueprint → Gemini generates full HTML
Self-contained single-file HTML with Tailwind CSS, Alpine.js, and Google Fonts via CDN
Anti-AI design system enforces editorial neo-minimalist aesthetics (no glassmorphism, no neon)
HTML validation (DOCTYPE, structure, size cap at 500KB) and sanitization (strips unauthorized scripts)
Strict CSP headers on public serving endpoint; frontend wraps in sandboxed iframe
Public /demo/:leadId route — recipients click directly from email, no auth required
Demo view count tracking for engagement analytics
Admin preview, regeneration, and status tracking in lead detail view
Configurable via GEMINI_API_KEY, DEMO_GENERATION_ENABLED, DEMO_MAX_PER_DAY

🧵 Threads Integration

Meta Threads API integration for social outreach discovery
Autonomous discovery, qualification, and engagement pipeline
Rate-limited client with token management and retry logic

🔄 Pipeline Stages

┌────────────────────────────────────────────────────────────────────────────┐
│                     COLD SCOUT AUTONOMOUS PIPELINE                         │
│                                                                            │
│  Stage 1        Stage 2        Stage 3        Stage 4        Stage 5       │
│                                                                            │
│  ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐        │
│  │DISCOV│ ───▶ │SCRAPE│ ───▶ │QUALIF│ ───▶ │PERSON│ ───▶ │OUTREA│        │
│  │  ERY │      │  &   │      │ICATI │      │ALIZA │      │  CH  │        │
│  │      │      │ENRICH│      │  ON  │      │  TION│      │      │        │
│  └──────┘      └──────┘      └──────┘      └──────┘      └──────┘        │
│  Google        Playwright    Groq AI        Groq AI        Brevo          │
│  Places API    BeautifulSoup  Llama 3        Email+PDF+Demo SMTP           │
│  ↓             ↓              ↓              ↓              ↓              │
│  Stage 6       Stage 7        Stage 8                                      │
│  ┌──────┐      ┌──────┐      ┌──────┐                                     │
│  │TRACK │ ───▶ │FOLLOW│ ───▶ │REPORT│                                     │
│  │  ING │      │  -UP │      │  ING │                                     │
│  └──────┘      └──────┘      └──────┘                                     │
│  Pixel +       Auto          Daily          All stages run on             │
│  IMAP          Sequences     Analytics      APScheduler cron              │
└────────────────────────────────────────────────────────────────────────────┘

Each stage is independently schedulable via jobs_config.json with hour/minute precision. The Job Manager allows pausing, resuming, and manual triggering of any individual stage from the dashboard.

👥 User Roles & Plans

graph LR
    subgraph "Roles (fixed at creation)"
        F[👨‍💻 Freelancer<br/>Full Pipeline Access]
        C[👤 Client<br/>View-Only Access]
    end

    subgraph "Freelancer Plans"
        FREE[Free<br/>Dashboard Skeleton<br/>Upgrade Prompt]
        PRO[Pro ✦<br/>Full Dashboard<br/>Live Data Access]
        ENT[Enterprise ✦✦<br/>All Pro Features<br/>Priority Support]
    end

    F --> FREE
    F --> PRO
    F --> ENT
    C -->|Welcome + Reports| WELCOME[Welcome View]

Feature	Free	Pro	Enterprise	Client
Dashboard Overview	Skeleton	✅ Live	✅ Live	✅ Welcome
Lead Management	❌	✅	✅	❌
Pipeline Control	❌	✅	✅	❌
Campaign Management	❌	✅	✅	❌
Analytics	❌	✅	✅	✅ Reports
Scheduler Override	❌	✅	✅	❌
Inbox	❌	✅	✅	❌
Billing Management	✅ Upgrade	✅	✅	❌

💻 Quick Start

Prerequisites

Requirement	Version
Python	3.11+
Node.js	18+
PostgreSQL	14+ (or Supabase)
Docker & Compose	Latest (optional but recommended)

Option A: Docker (Recommended)

# 1. Clone the repository
git clone https://github.com/colddsam/coldscout.git
cd coldscout

# 2. Copy and configure environment
cp .env.example .env
# Edit .env with your API keys

# 3. Launch full stack
docker-compose up --build

API available at http://localhost:8000/docs · Dashboard at http://localhost:5173

Option B: Manual Setup

# ── Backend ──────────────────────────────────────────────────
cd backend
python -m venv venv && source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium

# Configure environment
cp .env.example .env    # Fill in required values

# Initialize database
python scripts/create_tables.py
python scripts/seed_admin.py

# Start API server
uvicorn app.main:app --reload --host 127.0.0.1 --port 8000

# ── Frontend (new terminal) ───────────────────────────────────
cd frontend
npm install

# Configure environment
# Create .env.local with VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY, VITE_PROXY_URL, VITE_API_KEY

# Start dashboard
npm run dev

🔐 Environment Variables

See DEPLOYMENT.md for detailed setup instructions for each service.

Category	Variable	Description
Security	`APP_ENV`	`production` or `development`
	`APP_SECRET_KEY`	Hex session secret
	`API_KEY`	System-level auth key
	`SECURITY_SALT`	Encrypted fallback hash
	`BACKEND_CORS_ORIGINS`	Comma-delimited allowed origins
	`APP_URL`	Application root URL
Database	`DATABASE_URL`	`postgresql+asyncpg://...` URI
	`REDIS_URL`	Redis connection for Pipeline Log UI (Required for monitoring)
	`SUPABASE_URL`	Supabase project URL
	`SUPABASE_ANON_KEY`	Supabase public key
AI	`GROQ_API_KEY`	Groq Cloud API key
	`GROQ_MODEL`	`llama-3.1-8b-instant` (default)
	`GOOGLE_PLACES_API_KEY`	Maps Places API key
Outreach	`BREVO_SMTP_HOST/PORT/USER/PASSWORD`	SMTP relay credentials
	`FROM_EMAIL` / `FROM_NAME`	Sender identity
	`REPLY_TO_EMAIL`	Reply routing address
Tracking	`IMAP_HOST/USER/PASSWORD`	Inbound email sync
Alerts	`TELEGRAM_BOT_TOKEN/CHAT_ID`	Notification bot
	`WHATSAPP_NUMBER/CALLMEBOT_API_KEY`	WhatsApp alerts
Scheduling	`DISCOVERY_HOUR/QUALIFICATION_HOUR`	Pipeline execution times
	`PERSONALIZATION_HOUR/OUTREACH_HOUR`	Continued scheduling
	`REPORT_HOUR/REPORT_MINUTE`	Analytics execution
Discovery	`DISCOVERY_COUNTRY_FOCUS`	Comma-separated ISO country codes (e.g. `IN,US,AE`)
	`DISCOVERY_TARGET_COUNT`	Targets per daily run (default: 4)
	`DISCOVERY_DEPTH`	Location depth: `country`/`region`/`city`/`sub_area`
	`DISCOVERY_MAX_PAGES`	Google Places pages per search (1-3)
Demo Builder	`GEMINI_API_KEY`	Google Gemini API key for demo generation
	`DEMO_GENERATION_ENABLED`	Master kill-switch (`true`/`false`)
	`DEMO_MAX_PER_DAY`	Max demos per day (default: 10)
	`FRONTEND_DOMAIN`	Public frontend URL for demo links
Billing	`RAZORPAY_KEY_ID/KEY_SECRET`	Payment gateway
Frontend	`VITE_SUPABASE_URL/ANON_KEY`	Auth provider
	`VITE_PROXY_URL`	Backend URL for proxy
	`VITE_API_KEY`	Must match backend `API_KEY`

🚢 Deployment

The production stack is deployed across three specialized platforms:

┌──────────────────────────────────────────────────────┐
│                 PRODUCTION TOPOLOGY                   │
│                                                      │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐       │
│  │ Supabase │    │  Render  │    │  Vercel  │       │
│  │          │    │          │    │          │       │
│  │PostgreSQL│◀───│ FastAPI  │◀───│ React 19 │       │
│  │   Auth   │    │ Backend  │    │Dashboard │       │
│  │  Managed │    │ Docker   │    │  CDN Edge│       │
│  └──────────┘    └──────────┘    └──────────┘       │
│      DB Tier        API Tier      Frontend Tier      │
└──────────────────────────────────────────────────────┘

Refer to DEPLOYMENT.md for step-by-step production deployment instructions.

Backend: backend/DEPLOYMENT.md — Render + Docker
Frontend: frontend/DEPLOYMENT.md — Vercel + Nginx

🧪 Testing

The backend includes a comprehensive pytest test suite with 11 test modules:

tests/
├── test_01_api_health.py          ← Health endpoint checks
├── test_02_database_operations.py ← CRUD and DB operations
├── test_03_discovery_module.py    ← Google Places integration
├── test_04_daily_pipeline.py      ← Full pipeline orchestration
├── test_05_e2e_scenarios.py       ← End-to-end user scenarios
├── test_06_followup_engine.py     ← Follow-up sequence logic
├── test_07_reply_classifier.py    ← Intent classification
├── test_08_enrichment_modules.py  ← Scraping & enrichment
├── test_09_pipeline_api.py        ← Pipeline REST endpoints
├── test_10_leads_api.py           ← Leads REST endpoints
└── test_11_demo_builder.py        ← Demo website generation & serving

cd backend
pytest tests/ -v

CI runs automatically on every push via .github/workflows/ci.yml.

💖 Support the Project

If Cold Scout accelerates your B2B operations, please consider supporting its development:

⭐ Star this repo if Cold Scout is useful to you.

Engineered for High-Performance B2B Strategic Operations.

Name		Name	Last commit message	Last commit date
Latest commit History 143 Commits
.github		.github
backend		backend
coldscout-oss		coldscout-oss
docs		docs
frontend		frontend
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
DEPLOYMENT.md		DEPLOYMENT.md
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

📖 Table of Contents

🏛 Brand Identity

Vision

Mission

Design Philosophy

🚀 Project Overview

📁 Monorepo Structure

🏗 System Architecture

High-Level Overview

Autonomous Pipeline Flow

Database Entity Relationships

🛠 Tech Stack

Backend

Frontend

✨ Key Features

🔄 Pipeline Stages

👥 User Roles & Plans

💻 Quick Start

Prerequisites

Option A: Docker (Recommended)

Option B: Manual Setup

🔐 Environment Variables

🚢 Deployment

🧪 Testing

💖 Support the Project

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 34

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages