AI-Powered Client Screening Tool Cuts Freelancer Onboarding Time

Freelancers and small agencies often face a daunting task: sifting through a constant stream of client inquiries to identify the few that are worth pursuing. A new tool, ClearVet, aims to automate this tedious process by leveraging AI to evaluate potential clients across six critical dimensions, cutting screening time and reducing missed opportunities.

The inspiration for ClearVet came from an unexpected source—a comment on a three-week-old blog post. The reader posed a question that resonated deeply with the developer behind the project: "The space has a lot of tools for the work side but almost nothing for evaluating the client side before committing. What’s the specific problem you’re solving for freelancers?" Without a ready answer, the developer added the challenge to their build list, determined to find a solution.

The Client Screening Bottleneck

For freelancers and automation agencies, client inquiries are a double-edged sword. On one hand, they represent potential revenue; on the other, they consume valuable time. A typical scenario involves receiving 20 inquiries weekly, each requiring manual review to assess budget fit, problem clarity, timeline realism, and other critical factors. This process alone can consume hours—time that could be spent delivering actual work.

ClearVet was designed to eliminate this inefficiency. By automating the evaluation process, the tool enables freelancers to focus on high-value tasks while ensuring only the most promising leads are pursued.

How ClearVet Works: A Step-by-Step Breakdown

The client screening system operates through a seamless integration of tools and automation, ensuring minimal manual intervention and maximum efficiency.

1. Data Collection via Typeform

Potential clients submit their inquiries through a standardized Typeform, which captures essential details such as budget, problem description, and timeline expectations.

1. Webhook Integration with n8n

Submissions are automatically forwarded to an n8n workflow via webhook, triggering the next phase of the evaluation process.

1. FastAPI Endpoint Processing

The submission is sent to a FastAPI endpoint, which acts as the gateway for further evaluation. This endpoint ensures quick responses while offloading heavy processing to background tasks.

1. AI-Powered Evaluation with Claude

A background task powered by Claude API assesses the inquiry across six key dimensions:

• Budget Fit: Is the proposed budget realistic for the solution?
• Problem Clarity: How well-defined and specific is the problem?
• Timeline Realism: Is the proposed timeline achievable?
• AI Readiness: Is the client prepared to adopt AI solutions?
• Industry Fit: Does the client’s industry align with the agency’s capabilities?
• Growth Potential: What is the long-term revenue potential of this client?

Each dimension is scored from 0 to 10, with detailed reasoning provided for transparency. The overall score determines whether the inquiry is categorized as HIGH, MEDIUM, or LOW.

1. Slack Notifications and Human Approval

Once the evaluation is complete, a Slack message is sent to the freelancer or agency, displaying the scores, reasoning, and approval buttons. The human reviewer can then approve or reject the inquiry via API, ensuring accountability and control.

1. Audit Trail in PostgreSQL

Every decision, score, and reasoning is logged in a PostgreSQL database, creating a full audit trail for future reference. This ensures nothing is lost and every step is traceable.

A Real-World Evaluation Example

To illustrate how ClearVet operates in practice, consider the evaluation of a logistics company:

{
  "company_name": "Nairobi Logistics Ltd",
  "overall_score": 7.5,
  "recommendation": "high",
  "scores": {
    "problem_clarity": {
      "score": 9,
      "reasoning": "Problem is exceptionally well-defined"
    },
    "growth_potential": {
      "score": 8,
      "reasoning": "200 reports daily suggests high volume"
    }
  },
  "status": "approved",
  "approved_by": "Cess"
}

In this case, the inquiry scored highly on problem clarity and growth potential, leading to an overall recommendation of HIGH. The human reviewer approved the client, and the decision was logged for future reference.

Key Differentiators: Why ClearVet Stands Out

ClearVet distinguishes itself from other client screening tools through three core features:

• Human-in-the-Loop Decision Making

While AI handles the heavy lifting of analysis, every decision ultimately rests with the human reviewer. This ensures accountability and prevents automated bias.

• Comprehensive Audit Trail

Every evaluation, score, reasoning, and decision is stored in PostgreSQL, providing a complete history of client interactions. This is invaluable for tracking trends, improving processes, and ensuring compliance.

• Background Processing for Speed

The system responds to inquiries almost instantly, as the AI evaluation runs in the background. Notifications are sent to Slack only when the analysis is complete, allowing freelancers to stay focused on their work.

The ROI of Automation in Client Screening

For a single agency, implementing a system like ClearVet can cost between KES 80,000 and 150,000 as a setup fee. However, the return on investment is immediate and measurable. By replacing hours of manual screening with a fully automated process, freelancers can reclaim valuable time, reduce burnout, and increase their capacity to take on more projects.

The project is part of a 100-day coding challenge, with 37 days remaining in the journey. The full codebase is available on GitHub for those interested in exploring or contributing to the project.

The future of client screening lies in automation, and tools like ClearVet are paving the way for a more efficient and productive freelance ecosystem. As AI continues to evolve, we can expect even more sophisticated solutions to emerge, further transforming how freelancers and agencies operate. For now, ClearVet stands as a testament to the power of automation in solving real-world challenges.