deadline-suggester 1.0.0

Deadline Suggester

deadline-suggester

Realistic job deadline recommendations for freelance and contract workflows.

pip install deadline-suggester

Python 3.9+

---

Overview

deadline-suggester analyzes job specifications and historical completion data to recommend achievable deadlines, accounting for agent availability and rush pricing.

---

Quick Start

from deadline_suggester import DeadlineSuggesterClient, JobSpecification

client = DeadlineSuggesterClient()

job = JobSpecification( job_type="translation", complexity="medium", word_count=2000, attachments=1, budget_usd=150.0, preferred_deadline_hours=24.0, )

recommendation = client.recommend(job) print(recommendation.suggested_deadline) print(recommendation.recommended_hours)

---

API Reference

JobSpecification

Describes the job to be evaluated.

Parameter	Type	Description
job_type	str	Category of work
complexity	str	low, medium, or high
word_count	int | None	Optional word count
attachments	int	Number of attachments
budget_usd	float	Job budget in USD
preferred_deadline_hours	float | None	Client preferred deadline

DeadlineSuggesterClient Methods

Method	Description
recommend(job)	Returns a DeadlineRecommendation for the given JobSpecification
record_completion(job, actual_hours)	Records actual completion time to improve future estimates
estimate_availability()	Returns an AgentAvailability snapshot
rush_premium(job)	Returns the rush multiplier for expedited delivery

---

License

MIT