Skip to content

AnasInno/quickaudit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

quickaudit ⚡

Audit your business operations and see where AI agents could save you time and money.

quickaudit is a Python CLI tool that asks your team a series of questions about how they spend their time, then generates a professional ROI report showing exactly where AI automation makes sense — and how quickly it pays for itself.

Built by ShortlistOps — we build AI agents for UK businesses.


Terminal Output

──────────── quickaudit ⚡ AI Automation ROI Estimator ────────────

╭──────────────────── AI Automation Audit ───────────────────────╮
│ Apex Recruitment Ltd                                           │
│ Industry: Recruitment   Team: 12   Hourly rate: £28/hr         │
│ Tools: Bullhorn, LinkedIn Recruiter, Google Workspace          │
╰────────────────────────────────────────────────────────────────╯

                         Task Breakdown
┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┓
┃ Task                 ┃  Hrs/wk  ┃ Annual Cost ┃ Auto % ┃  Conservative ┃
┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━┩
│ CV Screening         │   15.0h  │     £21,840 │  80%   │     £8,736 🟢 │
│ CRM Updates          │    8.0h  │     £11,648 │  65%   │     £3,786 🟢 │
│ Candidate Outreach   │   10.0h  │     £14,560 │  70%   │     £5,096 🟢 │
│ Interview Scheduling │    6.0h  │      £8,736 │  85%   │     £3,712 🟢 │
│ Compliance Checks    │    5.0h  │      £7,280 │  60%   │     £2,184 🟡 │
└──────────────────────┴──────────┴─────────────┴────────┴───────────────┘

╭──────────────────────── 💰 ROI Summary ────────────────────────╮
│ Total hrs/week on automatable work:  44.0h                     │
│ Total annual cost of that work:      £64,064                   │
│                                                                │
│ Optimistic annual savings:           £46,462                   │
│ Conservative annual savings (50%):   £23,514                   │
│                                                                │
│ Recommended first project:  CV Screening (~£8,736/yr saved)    │
│ Estimated project cost:     £2k – £5k (one-off)                │
│ ROI multiple:               6.7×                               │
│ Payback period:             1.8 months                         │
╰────────────────────────────────────────────────────────────────╯

Installation

# From PyPI (once published)
pip install quickaudit

# From source (dev)
git clone https://github.com/AnasInno/quickaudit.git
cd quickaudit
pip install -e .

Requirements: Python 3.10+, click, rich


Usage

Interactive mode (recommended)

quickaudit

Walks you through a short questionnaire:

  1. Business name
  2. Industry (accountancy / recruitment / digital agency / other)
  3. Team size and average hourly rate
  4. Hours per week on each task category
  5. Current tools in use

Quick mode

Use industry defaults — no questions, instant estimate:

quickaudit --quick --industry accountancy --team-size 15
quickaudit --quick --industry recruitment --team-size 8 --hourly-rate 30
quickaudit --quick --industry digital-agency --team-size 6

Save a Markdown report

quickaudit --output report.md
# or combine with quick mode:
quickaudit --quick --industry recruitment --team-size 12 --output report.md

See examples/sample-report.md for what the output looks like.

All options

Options:
  --quick                Use industry defaults (no interactive prompts)
  --industry [accountancy|recruitment|digital-agency|other]
  --team-size INTEGER    Number of people in the team
  --hourly-rate FLOAT    Average hourly staff cost in GBP  [default: 25.0]
  --output / -o PATH     Save Markdown report to this file
  --version              Show version and exit
  --help                 Show help and exit

Industry Templates

Industry Tasks covered
Accountancy Invoice processing, client doc chasing, month-end reconciliation, tax return prep, client queries
Recruitment CV screening, candidate outreach, interview scheduling, CRM updates, compliance checks
Digital Agency Lead qualification, client reporting, project status updates, content scheduling, support tickets
Other Data entry, email management, document processing, reporting, customer support

How the ROI maths works

We keep the methodology fully transparent — no magic numbers.

For each task:

  annual_cost          = hours_per_week × 52 × hourly_rate
  optimistic_saving    = annual_cost × automation_potential
  conservative_saving  = optimistic_saving × 0.50   ← 50% credibility haircut

Summary:

  roi_multiple   = conservative_saving ÷ mid-point project cost
  payback        = project_cost ÷ (conservative_saving / 12)

Project cost tiers (one-off implementation):

Complexity Cost
Simple (single workflow, low integration) £997
Standard (2–4 integrations, moderate logic) £2k – £5k
Complex (multi-system, advanced AI logic) £5k – £15k

Automation potential figures are drawn from ShortlistOps client engagements and published industry benchmarks. We apply a 50% haircut to all estimates so that the numbers we put in front of clients are conservative and defensible.


Project structure

quickaudit/
├── quickaudit/
│   ├── __init__.py      Version and package metadata
│   ├── cli.py           CLI entry point (Click)
│   ├── auditor.py       Interactive + quick audit logic
│   ├── calculator.py    ROI engine
│   ├── report.py        Terminal (Rich) + Markdown output
│   └── templates.py     Industry task templates
├── examples/
│   └── sample-report.md Example Markdown output
├── pyproject.toml
├── setup.py
└── LICENSE

Contributing

Issues and PRs welcome. Please keep the tool dependency-free of LLMs — the value is in the transparent, deterministic maths.


License

MIT © ShortlistOps


Built by ShortlistOps — we build AI agents for UK businesses.
Book a free 30-min audit call: shortlistops.co.uk

About

CLI tool that audits business operations and estimates AI automation ROI

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages