| --- |
| title: PakFreelance |
| emoji: 🚀 |
| colorFrom: purple |
| colorTo: blue |
| sdk: streamlit |
| app_file: app.py |
| pinned: false |
| --- |
| |
| # 🇵🇰 PakFreelance — AI Freelance Toolkit |
|
|
| > **Professional AI Agent Toolkit for Pakistani Freelancers** |
| > *AMD Developer Hackathon 2026 | Track 1: AI Agents & Agentic Workflows* |
|
|
| **Powered by AMD MI300X through Groq's optimized API, running Llama 3.3 70B for fast inference. Deployed on HuggingFace Spaces.** |
|
|
| --- |
|
|
| ## 🎯 Overview |
|
|
| **PakFreelance** is an AI-powered toolkit built with **CrewAI agents** that helps freelancers across Pakistan and South Asia: |
|
|
| ✅ **Generate winning proposals** in seconds (5-agent AI orchestration) |
| ✅ **Detect client scams** before wasting time (red flag analysis) |
| ✅ **Calculate optimal rates** based on skills and goals |
| ✅ **Score proposals** with detailed improvement feedback |
| ✅ **Write professional bios** for Upwork/Fiverr |
| ✅ **Analyze client websites** for legitimacy |
| ✅ **One-click Power Mode** for complete job analysis |
|
|
| Built for the **4M+ freelancers in Pakistan and South Asia** using **AMD MI300X infrastructure**, **Llama 3.3 70B**, and **CrewAI**. |
|
|
| --- |
|
|
| ## 🚀 Key Features |
|
|
| ### ⚡ Power Mode (One-Click Analysis) |
| Paste a job posting → Get **risk assessment + proposal + pricing strategy** in 3 columns |
|
|
| ### ✈️ Proposal Generator |
| 5 specialized AI agents working together: |
| 1. **Scout** - Extract job requirements |
| 2. **Researcher** - Analyze client context |
| 3. **Writer** - Generate personalized proposal (150-200 words) |
| 4. **Pricer** - Recommend optimal pricing |
| 5. **Reviewer** - Polish & finalize |
|
|
| ### 🚩 Red Flag Detector |
| - Identifies scam patterns |
| - Detects unrealistic budgets |
| - Spots exposure-only offers |
| - Provides safe response templates |
|
|
| ### ⭐ Proposal Scorer |
| - Scores out of 100 |
| - Breakdown by 7 criteria (Hook, Credibility, Understanding, Solution, etc.) |
| - Top 3 specific improvement suggestions |
|
|
| ### 💰 Rate Calculator |
| - Pakistan-specific pricing (30-50% lower than US rates) |
| - Experience multiplier |
| - Monthly goal calculation |
| - Tax & platform fee buffer |
| - Three-tier pricing strategy (Start/Target/Premium) |
|
|
| ### 📝 Profile Bio Writer |
| - Upwork/Fiverr optimized |
| - Compelling headlines |
| - Professional 150-200 word bios |
| - Personality-driven tone |
|
|
| ### 🌐 Website Analyzer |
| - Extract website content |
| - Analyze for red flags |
| - Assess client legitimacy |
|
|
| ### 📄 Document Reader |
| - Upload CV & Job PDFs |
| - Extract relevant info |
| - Provide smarter analysis |
|
|
| --- |
|
|
| ## 🛠️ Tech Stack |
|
|
| | Component | Technology | Purpose | |
| |-----------|-----------|---------| |
| | **AI Framework** | CrewAI | Multi-agent orchestration | |
| | **LLM** | Llama 3.3 70B (via Groq) | Fast inference on AMD MI300X | |
| | **Infrastructure** | AMD MI300X (via Groq API) | GPU acceleration | |
| | **Web Framework** | Streamlit | Beautiful UI | |
| | **Document Export** | python-docx | Word document generation | |
| | **PDF Support** | PyPDF2 | PDF reading | |
| | **Web Scraping** | requests | Website text extraction | |
|
|
| --- |
|
|
| ## 📋 System Architecture |
|
|
| ``` |
| ┌─────────────────────────────────────────────────────────┐ |
| │ PAKFREELANCE APP │ |
| │ (Streamlit Web Interface) │ |
| └──────────────────┬──────────────────────────────────────┘ |
| │ |
| ┌──────────┴──────────┐ |
| │ │ |
| ▼ ▼ |
| ┌────────────┐ ┌──────────────┐ |
| │ Job Input │ │ User Profile │ |
| └──────┬─────┘ └──────┬───────┘ |
| │ │ |
| └───────┬───────────┘ |
| ▼ |
| ┌──────────────────────┐ |
| │ CrewAI Agents: │ |
| ├──────────────────────┤ |
| │ • Scout Agent │ |
| │ • Researcher Agent │ |
| │ • Writer Agent │ |
| │ • Pricer Agent │ |
| │ • Reviewer Agent │ |
| └───────┬──────────────┘ |
| │ |
| ▼ |
| ┌──────────────────────┐ |
| │ Groq API Call │ |
| │ (Llama 3.3 70B) │ |
| │ │ |
| │ AMD MI300X Powered │ |
| └───────┬──────────────┘ |
| │ |
| ▼ |
| ┌──────────────────────┐ |
| │ Output Results: │ |
| ├──────────────────────┤ |
| │ • Proposals │ |
| │ • Red Flags │ |
| │ • Rates │ |
| │ • Scores │ |
| │ • Bios │ |
| └──────────────────────┘ |
| ``` |
|
|
| --- |
|
|
| ## 📦 Installation |
|
|
| ### 1. Clone Repository |
| ```bash |
| git clone https://github.com/yourusername/pakfreelance.git |
| cd pakfreelance |
| ``` |
|
|
| ### 2. Create Virtual Environment (Optional but Recommended) |
| ```bash |
| python -m venv venv |
| source venv/bin/activate # On Windows: venv\Scripts\activate |
| ``` |
|
|
| ### 3. Install Dependencies |
| ```bash |
| pip install -r requirements.txt --break-system-packages |
| ``` |
|
|
| ### 4. Set Up Environment Variables |
| Create `.env` file in project root: |
| ```env |
| GROQ_API_KEY=your_groq_api_key_here |
| ``` |
|
|
| **Get API Keys:** |
| - **Groq:** https://console.groq.com (Free tier: 12,000 TPM) |
|
|
| ### 5. Run Application |
| ```bash |
| streamlit run app.py |
| ``` |
|
|
| Visit: `http://localhost:8501` |
|
|
| --- |
|
|
| ## 🎮 Usage Guide |
|
|
| ### Power Mode (Quickest) |
| 1. Click **⚡ Power Mode** in sidebar |
| 2. Paste job posting |
| 3. Click **🚀 Run Complete Analysis** |
| 4. Get risk assessment + proposal + rates in 3 columns |
| 5. Click expanders for full results |
|
|
| ### Proposal Generator |
| 1. Paste job posting |
| 2. (Optional) Enter your skill & experience |
| 3. Click **✈️ Generate Proposal** |
| 4. Review proposal |
| 5. Download as Word document (.docx) |
|
|
| ### Red Flag Detector |
| 1. Choose: **Job Description** or **Website URL** |
| 2. Paste job or enter website |
| 3. Click **🔍 Analyze for Red Flags** |
| 4. Get risk level + specific red flags |
| 5. Copy safe response template if HIGH RISK |
|
|
| ### Rate Calculator |
| 1. Enter skill (e.g., "Python Developer") |
| 2. Enter years of experience |
| 3. Enter monthly income goal (USD) |
| 4. Enter available hours/week |
| 5. Click **💰 Calculate Rate** |
| 6. Get optimal hourly rate + pricing strategy |
|
|
| ### Proposal Scorer |
| 1. Paste your proposal |
| 2. Click **⭐ Score My Proposal** |
| 3. Get score out of 100 + breakdown + improvements |
|
|
| ### Profile Bio Writer |
| 1. Enter name, skill, experience |
| 2. (Optional) Specialization & achievements |
| 3. Click **📝 Generate Bio** |
| 4. Get headline + professional bio |
|
|
| --- |
|
|
| ## 📊 Example Output |
|
|
| ### Proposal Generated |
| ``` |
| Professional Proposal |
| Generated by: PakFreelance AI Toolkit |
| |
| Building a complete e-commerce platform with a MERN stack is exactly |
| the kind of challenge I enjoy solving. I have 5+ years of experience |
| building scalable applications for e-commerce clients, including 10+ |
| projects with React, Node.js, and MongoDB. |
| |
| I'll design a responsive UI using React, implement a robust backend |
| with Node.js and MongoDB, integrate Stripe for payments, and set up |
| JWT authentication. You'll get a GitHub repo and full documentation. |
| |
| I'm available immediately and can deliver within your 20-day timeline... |
| |
| Best regards, |
| [Your Name] |
| |
| --- |
| Generated by PakFreelance AI |
| Powered by AMD MI300X • CrewAI • Llama 3.3 70B |
| ``` |
|
|
| ### Rate Calculation |
| ``` |
| OPTIMAL HOURLY RATE: $15 - $30/hour |
| |
| CALCULATION BREAKDOWN: |
| - Monthly goal: $3000 |
| - Weeks per month: 4.3 |
| - Hours per week: 30 |
| - Base rate needed: $22.08/hour |
| - Market rate for Prompt Engineering: $25 - $50/hour |
| - Experience multiplier (2 years): 1.2 |
| - Adjusted rate: $20 - $40/hour |
| - Considering Pakistani context: $15 - $30/hour |
| |
| PRICING STRATEGY: |
| - Start at: $15/hour (to build reviews) |
| - Target rate: $25/hour (once established) |
| - Premium rate: $35/hour (for repeat clients) |
| ``` |
|
|
| --- |
|
|
| ## 🏗️ Project Structure |
|
|
| ``` |
| pakfreelance/ |
| ├── app.py # Main Streamlit app (650+ lines) |
| ├── agents.py # CrewAI agents + tasks (150+ lines) |
| ├── red_flags.py # Red flag detection agent |
| ├── proposal_scorer.py # Proposal scoring agent |
| ├── rate_calculator.py # Rate calculation agent |
| ├── profile_bio_writer.py # Bio generation agent |
| ├── requirements.txt # Python dependencies |
| ├── .env.example # Example environment variables |
| ├── README.md # This file |
| └── .gitignore # Git ignore patterns |
| ``` |
|
|
| --- |
|
|
| ## 📋 Dependencies |
|
|
| ``` |
| crewai==0.25.0 # Multi-agent orchestration |
| streamlit==1.28.0 # Web UI framework |
| groq==0.4.1 # Groq API client |
| litellm==1.0.0 # LLM wrapper |
| python-dotenv==1.0.0 # Environment variables |
| python-docx==0.8.11 # Word document creation |
| PyPDF2==3.0.1 # PDF reading |
| requests==2.31.0 # HTTP requests |
| duckduckgo-search==3.8.4 # Web search (optional) |
| ``` |
|
|
| Full list: See `requirements.txt` |
|
|
| --- |
|
|
| ## 🎯 AMD Technology Integration |
|
|
| ### Infrastructure Overview |
|
|
| This project leverages **AMD MI300X GPUs through Groq's optimized API**: |
|
|
| - **LLM:** Llama 3.3 70B (AMD-optimized model) |
| - **Inference:** Groq API (runs on AMD MI300X) |
| - **Performance:** Fast token generation (100+ tokens/sec) |
| - **Hosting:** HuggingFace Spaces (production-ready) |
|
|
| ### How AMD Powers This Application |
|
|
| 1. **AMD MI300X GPU Compute** |
| - All AI inference runs on AMD Instinct MI300X architecture |
| - Powered via Groq's AMD-optimized endpoints |
| - Fast token generation (100+ tokens/sec) |
| - Cost-effective for production workloads |
|
|
| 2. **ROCm Support** |
| - Llama 3.3 70B is ROCm-compatible |
| - Optimized for AMD Instinct MI300X |
| - Can scale to local AMD GPU clusters with ROCm |
|
|
| 3. **CrewAI Multi-Agent Orchestration on AMD** |
| - 5 specialized agents working in sequence |
| - All processing runs on AMD MI300X hardware |
| - Demonstrates scalable agent architecture |
|
|
| 4. **Why AMD for This Project** |
| - ✅ Cost-effective inference (free API tier) |
| - ✅ Production-ready infrastructure |
| - ✅ Supports open-source models (Llama 3.3) |
| - ✅ Scalable to enterprise deployments |
| - ✅ No vendor lock-in (ROCm is open source) |
|
|
| --- |
|
|
| ## 🚀 Deployment |
|
|
| ### Hugging Face Spaces (Recommended) |
|
|
| 1. Create Hugging Face Space at https://huggingface.co/spaces |
| 2. Select Streamlit SDK |
| 3. Connect GitHub repository |
| 4. Add environment variable: `GROQ_API_KEY` |
| 5. Deploy automatically (3-5 minutes) |
| 6. Get live URL for submission |
|
|
| ### Local Testing |
| ```bash |
| streamlit run app.py |
| ``` |
|
|
| --- |
|
|
| ## 🐛 Troubleshooting |
|
|
| ### "RateLimitError from Groq" |
| Wait 8 seconds between requests. Free tier: 12,000 TPM (tokens per minute) |
|
|
| ### "Invalid API Key" |
| Check `.env` file - make sure key starts with `gsk_` and has no extra spaces |
|
|
| ### "ModuleNotFoundError" |
| ```bash |
| pip install module-name --break-system-packages |
| ``` |
|
|
| --- |
|
|
| ## 📝 License |
|
|
| MIT License - See LICENSE file for details |
|
|
| --- |
|
|
| ## 🙏 Acknowledgments |
|
|
| - **AMD Developer Program** - Infrastructure & credits |
| - **lablab.ai** - Hackathon platform |
| - **CrewAI** - Multi-agent orchestration framework |
| - **Groq** - Fast LLM inference on AMD MI300X |
| - **Llama 3.3 70B** - Powerful open-source language model |
| - **Streamlit** - Beautiful web framework |
|
|
| --- |
|
|
| ## 📞 Support |
|
|
| - **Documentation:** See this README |
| - **Issues:** Open a GitHub issue |
| - **Setup Help:** Check `.env.example` for environment variables |
|
|
| --- |
|
|
| ## 🚀 Future Roadmap |
|
|
| ### Current (v1.0) |
| - ✅ Multi-agent proposal generation |
| - ✅ Red flag detection |
| - ✅ Rate calculation |
| - ✅ Proposal scoring |
| - ✅ Bio generation |
| - ✅ Website analysis |
| - ✅ Power Mode |
|
|
| ### Planned (v2.0) |
| - Document upload & analysis |
| - Browser extension |
| - Mobile app |
| - Multi-language support |
|
|
| ### Stretch Goals (v3.0) |
| - Fine-tuned models |
| - Real-time job scraping |
| - Auto-apply features |
| - Client management dashboard |
|
|
| --- |
|
|
| **Built with ❤️ for Pakistani Freelancers** |
| **Powered by AMD MI300X through Groq** |
| **AMD Developer Hackathon 2026 - Track 1: AI Agents** |
|
|
| *Last Updated: May 8, 2026* |
|
|
