velox-gtm 2.0.2

Open-source GTM automation CLI: LinkedIn ICP scoring, Notion ERP provisioning, Google Docs compiler, and closed-won sales-to-ops handoff.

Velox — GTM Automation Engine

---

Your sales team closes a deal. Someone then manually copies the company into Notion, creates a delivery project, drafts a proposal in Google Docs, and pastes Slack alerts by hand. Velox automates that entire handoff.

Velox is an open-source Python CLI that connects LinkedIn lead capture → ICP scoring → Notion sales pipeline → closed-won ops provisioning → Google Docs proposal generation. One system, zero data-entry.

---

---

See it in 60 seconds (zero setup)

The ICP scoring engine runs completely offline — no API keys, no accounts, no config:

pip install velox-gtm
velox --demo

You'll see a LinkedIn inbound lead event parsed, scored against a 3-axis ICP matrix (industry fit, company size, title seniority), and routed to a generated n8n webhook payload — all in one terminal scroll.

No OAuth. No Notion account. No credentials.json. Just pip install and velox --demo.

---

What Velox automates

Workflow	What it does	Setup required
ICP Lead Scoring	Scores B2B leads 0–100 across industry, headcount, and seniority. Routes to Tier 1/2/3.	None — runs offline
Notion ERP Deploy	Provisions Pipeline Tracker (Sales) ↔ Client Vault & Project Delivery (Operations) as linked relational databases	Notion API key
Closed-Won Provisioning	Detects a deal moving to Closed-Won in Notion, auto-creates the delivery project, attaches a Google Doc contract, and links both records	Notion API key
Google Docs Compiler	Transforms Markdown strategy blueprints into formatted Google Docs with headings, callouts, and structured sections	Google OAuth
n8n Webhook Bridge	Generates valid n8n OAuth 2.0 credential payloads and webhook trigger bodies for any workflow above	n8n instance

---

Quickstart

Option A — Try the demo (no setup)

pip install velox-gtm
velox --demo

Option B — Full engine with credentials

1. Clone and install

git clone https://github.com/dhruv-atomic-mui21/velox.git
cd velox
pip install -r requirements.txt
pip install -e .

2. Configure your environment

cp .env.example .env
# Edit .env with your keys (see Credentials Setup below)

3. Launch the CLI

velox

---

Credentials Setup

Only needed for Options 1–4 in the full CLI. Option 5 (ICP scoring demo) and Option 6 (local blueprint reader) require no credentials.

Notion API key (Options 1 & 4)

1. Go to notion.so/my-integrations → New integration
2. Copy the Internal Integration Token (starts with secret_)
3. Add NOTION_API_KEY=secret_... to your .env
4. Share your target Notion page with the integration

Google OAuth (Options 2 & 3)

1. Go to console.cloud.google.com → Create a project
2. Enable the Google Docs API and Google Drive API
3. Create an OAuth 2.0 Client ID (Desktop app type)
4. Download credentials.json and place it in the project root
5. Run velox → Option 2 to complete the browser handshake

n8n Webhook URL (Optional)

Set N8N_WEBHOOK_URL in .env to your self-hosted or cloud n8n webhook endpoint.

---

ICP Scoring — how it works

The LinkedInGTMLeadEngine.score_lead() function is a standalone module you can import directly into any webhook server:

from linkedin_gtm import LinkedInGTMLeadEngine

engine = LinkedInGTMLeadEngine()
lead = engine.score_lead({
    "prospect_name": "Sarah Jenkins",
    "prospect_title": "VP of Revenue Operations",
    "company_name": "ApexLogistics AI",
    "industry": "Logistics",
    "employee_count": 180,
    "estimated_deal_value": 45000
})

print(f"ICP Score: {lead['icp_score']}/100 | Tier: {lead['icp_tier']}")
# ICP Score: 100/100 | Tier: Tier 1 (High Priority / Immediate Ops Booking)

Scoring breakdown:

• Industry fit — 35 pts (Finance, B2B Sales, Logistics, SaaS, Fintech)
• Company size — 40 pts (50–500 employees = full score; <50 = 15 pts; >500 = 25 pts)
• Title seniority — 25 pts (VP, Director, Head of, C-suite)

Tier routing: ≥75 = Tier 1 (immediate ops), ≥50 = Tier 2 (standard outreach), <50 = Tier 3 (nurture).

---

CLI Dashboard

┌─────────────────────────────────────────────────────────────────────────────┐
│   ██╗   ██╗███████╗██╗      ██████╗ ██╗  ██╗                               │
│   ██║   ██║██╔════╝██║     ██╔═══██╗╚██╗██╔╝                               │
│   ██║   ██║█████╗  ██║     ██║   ██║ ╚███╔╝                                │
│   ╚██╗ ██╔╝██╔══╝  ██║     ██║   ██║ ██╔██╗                                │
│    ╚████╔╝ ███████╗███████╗╚██████╔╝██╔╝ ██╗                               │
│     ╚═══╝  ╚══════╝╚══════╝ ╚═════╝ ╚═╝  ╚═╝                               │
│                                                                             │
│   OPEN-SOURCE GTM AUTOMATION ENGINE & SALES-TO-OPS OPERATING SYSTEM        │
└──────────────────────────────────────────────────── Version 2.0.1 (Open Source) ──┘

 1. Deploy Notion Business ERP Databases          ← requires Notion API key
 2. Run Google OAuth 2.0 Authenticator            ← requires credentials.json
 3. Create & Format Operational Blueprints        ← requires Google OAuth
 4. Run Relational Notion ERP Workflow            ← requires Notion API key
 5. Run LinkedIn GTM Lead Capture & ICP Scoring   ← NO SETUP REQUIRED ✓
 6. Read Local Operational Blueprints             ← NO SETUP REQUIRED ✓
 7. Exit

---

Contributing

Pull requests are welcome. If you want to add a new ICP scoring dimension, a new Notion schema, or a new webhook integration:

1. Fork → git checkout -b feature/your-feature
2. Commit → git commit -m 'Add: ...'
3. PR → describe what workflow it automates and what problem it removes

For bugs or feature requests, open an issue.

---

License

MIT — open-source for GTM engineers, growth teams, and RevOps builders.

Made by Satyaneev