Python Automation Portfolio

A curated, sanitized portfolio of automation scripts focused on:

• Telegram API parsing with rate limiting and retries
• Web automation (Playwright) and technology extraction
• Data processing utilities (validators, converters)
• Modular architecture, type hints, and documentation

Quick Start

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Install by module

# Telegram parsing
pip install -e .[telegram]

# Playwright tech audit
pip install -e .[audit]

# Execution scripts (crawl4ai, pdf, postgres)
pip install -e .[execution]

# Outreach utilities (OpenAI)
pip install -e .[outreach]

# Everything
pip install -e .[all]

Structure

• tech_audit_playwright/ — Playwright crawling + extractors
• Tools/telegram/execution/ — Telegram parsing tools
• Internal-Operations/Outreach/execution/ — outreach pipeline utilities
• execution/ — general data utilities and crawlers
• external/ — additional sanitized sources from other workspaces

Showcase

Highlights you can inspect quickly:

• Telegram parsing with rate limiting and error handling: Tools/telegram/execution/search_channels.py, Tools/telegram/execution/telegram_client.py
• Playwright automation and extraction patterns: tech_audit_playwright/scripts/run_audit.py, tech_audit_playwright/src/tech_audit_playwright/extractors.py
• Data processing and conversions: execution/enrich_companies_from_csv.py, execution/analyze_market_segments.py

Quick demo (no keys required):

python tech_audit_playwright/scripts/run_audit.py --url https://example.com --dry-run
python Tools/telegram/execution/search_channels.py --query "AI automation" --dry-run

Notes on Sanitization

This repository is generated from a private monorepo with a sanitization pipeline:

• allowlist-based export
• token/secret scanning
• domain/client name replacement

See docs/sanitization.md for details. Sanitized example outputs live in examples/.

Development

pip install -e .[dev]
make lint
make test