Complete Documentation
Your complete guide to using HUNARZ - Proof of Skill. Proof of Work.
What is HUNARZ?
HUNARZ is an AI-powered Proof of Skill Ecosystem that helps students, freshers, freelancers, job seekers, and rural youth learn, prove, earn, and get hired through real measurable work.
Learn
Micro-learning while working
Prove
Build your Hunarz Score
Earn
Get paid for your work
Get Hired
Based on real proof
HUNARZ replaces fake resumes, certificates, and portfolios with REAL PROOF - verified work, skill graphs, trust scores, and work history.
Getting Started
Quick Setup Guide
git clone https://github.com/hunarz/platform.git
cd hunarz
composer install
cp .env.example .env
php artisan migrate --seed
php -S localhost:8000
System Requirements
- PHP: 8.0 or higher
- Database: MySQL 5.7+ / MariaDB 10.2+
- Web Server: Apache / Nginx / PHP Built-in
- Extensions: PDO, cURL, GD, FileInfo, JSON, Session
- Memory: Minimum 2GB RAM
Success Indicator: When you see the HUNARZ homepage with "Build Proof. Get Trusted. Get Hired." - your setup is complete!
For Freelancers & Job Seekers
Step-by-Step Journey
1
Create Account
Sign up for free, complete your profile, set earning goals
2
Browse Tasks
Use filters to find tasks matching your skills
3
Complete Skill Evaluation
Answer AI-generated questions to demonstrate expertise
4
Submit Work with Video
Record video explanation (MANDATORY) + submit files
5
Get Reviewed & Paid
Company reviews within 24-48 hours, payment released
Pro Tip: Start with FREE tasks to build your initial Hunarz Score before applying for paid tasks!
For Companies & Employers
Hiring Workflow
1. Post Task
Create task with clear requirements and budget ($5-50)
2. Receive Submissions
Get video submissions from verified freelancers
3. Review & Rate
Rate quality, originality, communication (1-100 each)
4. Release Payment
Approve and pay - funds go to freelancer wallet
Task Posting Rules
- Budget Range: $5 - $50 maximum per task
- Duration Limit: Maximum 6 hours per task
- Free Tasks: Allowed for practice (no payment to freelancer)
- Commission: 5% from company + $5 posting fee
- Micro Internships: 7-day guided challenges available
Hunarz Score Calculation
| Metric | Weight | Description |
|---|
| Quality Score | 40% | How well your work meets requirements |
| Originality Score | 20% | Unique work, not copied or AI-generated |
| Communication Score | 20% | Clarity of video explanation and written submission |
| Speed Score | 10% | Meeting deadlines consistently |
| AI Collaboration Score | 10% | Effective use of AI tools |
Score Levels
Video Submission Guide
IMPORTANT: Video explanation is MANDATORY for all task submissions!
Why Video?
- ✓ Proves authenticity of your work (3x higher approval rate)
- ✓ Shows communication skills to employers
- ✓ Reduces AI-generated or plagiarized submissions
- ✓ Builds trust with companies
- ✓ Creates shareable proof for your portfolio
Best Practices
Speak clearly & confidently
📹 Sample Video Script:
"Hi, I'm [Name]. For this task, I needed to [task requirement].
I approached this by [your approach]. The main challenges were [challenges],
which I solved by [solutions]. Here's my final work [show work].
This task helped me learn [key takeaways]. Thanks for reviewing!"
Earnings & Payments
Commission Structure
| Fee Type | Percentage | Who Pays |
|---|
| Platform Commission | 5% | Freelancer (deducted from earnings) |
| Platform Commission | 5% | Company (added to task budget) |
| Withdrawal Fee | 2% | Freelancer (when withdrawing) |
| Task Posting Fee | $5 | Company per task |
Payment Timeline
- Submission → Review: 24-48 hours
- Approval → Payment: Instant to wallet
- Withdrawal Request → Processed: 24-48 hours
- Processed → Bank/PayPal: 2-5 business days
Earning Potential: Top freelancers earn $1000+ monthly. Beginners typically earn $200-500/month part-time.
AI Features
AI Career Copilot
Personal career advisor - ask any career question, get personalized recommendations
AI Skill Evaluation
Generates 3-5 questions per task, auto-grades descriptive answers using ChatGPT
Market Trend Analysis
Real-time insights on in-demand skills, growth rates, and earning potential
Skill Roadmap Engine
Personalized career path based on your goals and market demand
ChatGPT Integration: Add your OpenAI API key in Admin Panel → AI Configuration to enable all AI features.
Complete Testing Guide
Quick Test Flow
# 1. Start server
php -S localhost:8000
# 2. Open browser
http://localhost:8000
# 3. Test registration
# 4. Test task application
# 5. Test submission with video
# 6. Test company review
# 7. Test payment release
Test Cases Checklist
API Testing (using cURL)
# Test career advice API
curl -X POST http://localhost:8000/api/career-copilot \
-d "question=What skills should I learn?"
# Expected: JSON response with AI advice
Frequently Asked Questions
Payment is released immediately after company approves your submission. Funds go to your wallet instantly. Withdrawal requests take 24-48 hours for admin approval, then 2-5 business days to reach your bank/PayPal.
You'll receive detailed feedback explaining why. AI generates personalized improvement tips. You can revise and resubmit based on the feedback. Multiple revisions allowed.
Yes, minimum withdrawal is $10. 2% fee applies. Withdrawals are processed Monday-Friday within 24-48 hours.
YES! Video explanations are mandatory for all task submissions. Companies approve video submissions 3x faster because they prove authenticity and show communication skills.
Based on 5 metrics: Quality (40%), Originality (20%), Communication (20%), Speed (10%), AI Collaboration (10%). Score updates automatically after each approved task.
7-day guided challenges where you learn while working. Includes daily tasks, learning materials, mentorship, and completion certificate. Great for building real experience.
Demo Accounts
| Role | Email | Password | Purpose |
|---|
| Admin | admin@hunarz.com | Admin@2024 | Full platform control |
| Company | company@hunarz.com | Test@123 | Post tasks, hire freelancers |
| Freelancer | test@hunarz.com | Test@123 | Complete tasks, earn money |
Note: Demo accounts have limited functionality. For full testing, create your own account.
Troubleshooting
| Issue | Solution |
|---|
| White screen / Blank page | Enable PHP errors: error_reporting(E_ALL); ini_set('display_errors', 1); |
| Database connection failed | Check credentials in config/database.php. Ensure MySQL is running. |
| Login redirect loop | Verify session_start() in config.php. Check cookie settings. |
| Video upload fails | Check folder permissions: chmod 755 assets/uploads/. Max file size: 50MB. |
| AI not responding | Add OpenAI API key in Admin → AI Configuration. Check API credits. |
| Tasks not showing | Ensure task status = 'open' and payment_status = 'paid' in database. |
| Email not sending | Configure SMTP in config.php or use mailtrap for testing. |
| 404 errors on links | Update APP_URL in config.php to match your domain. |
Quick Debug Commands
# Check PHP version
php -v
# Check MySQL connection
mysql -u root -p -e "SELECT 1"
# Check database tables
mysql -u root -p hunarz_ultra -e "SHOW TABLES"
# Check error logs
tail -f /var/log/apache2/error.log
# Clear cache
rm -rf storage/framework/cache/*
Need Help?
Our support team is available 24/7