{"id":27700893,"url":"https://github.com/jayptl-me/hackhazards25_peer_hire","last_synced_at":"2025-07-17T00:33:58.552Z","repository":{"id":289917796,"uuid":"972212474","full_name":"jayptl-me/hackhazards25_peer_hire","owner":"jayptl-me","description":"PeerHire solves the problem of trust and transparency in freelance marketplaces by leveraging blockchain for secure transactions and AI for intelligent job matching and task verification.","archived":false,"fork":false,"pushed_at":"2025-05-14T15:38:53.000Z","size":438,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-14T16:47:25.155Z","etag":null,"topics":["base","blockchain","coinbase","coinbase-api","coinbase-wallet","groq","groq-api","layer2","llama","react","screenpipe","solidity","solidity-contracts","web3"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jayptl-me.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-24T17:57:40.000Z","updated_at":"2025-05-14T15:38:57.000Z","dependencies_parsed_at":"2025-04-25T19:08:27.329Z","dependency_job_id":"eb309745-2d33-42e9-8975-ad74cac7f852","html_url":"https://github.com/jayptl-me/hackhazards25_peer_hire","commit_stats":null,"previous_names":["jayptl-me/hackhazards25_peer_hire"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jayptl-me/hackhazards25_peer_hire","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayptl-me%2Fhackhazards25_peer_hire","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayptl-me%2Fhackhazards25_peer_hire/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayptl-me%2Fhackhazards25_peer_hire/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayptl-me%2Fhackhazards25_peer_hire/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jayptl-me","download_url":"https://codeload.github.com/jayptl-me/hackhazards25_peer_hire/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayptl-me%2Fhackhazards25_peer_hire/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265554790,"owners_count":23787280,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["base","blockchain","coinbase","coinbase-api","coinbase-wallet","groq","groq-api","layer2","llama","react","screenpipe","solidity","solidity-contracts","web3"],"created_at":"2025-04-25T19:08:21.704Z","updated_at":"2025-07-17T00:33:58.546Z","avatar_url":"https://github.com/jayptl-me.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![github-submission-banner](https://github.com/user-attachments/assets/a1493b84-e4e2-456e-a791-ce35ee2bcf2f)\n\n# 🚀 PeerHire: Decentralized Freelance Marketplace\n\n\u003e Connecting freelancers and clients securely through blockchain and AI.\n\n---\n\n## 📌 Problem Statement\n\n**Problem Statement 4 – Craft the Future of Onchain Consumer Experiences with Base**\n\n---\n\n## 🎯 Objective\n\nPeerHire solves the problem of trust and transparency in freelance marketplaces by leveraging blockchain for secure transactions and AI for intelligent job matching and task verification.\n\n---\n\n## 🧠 Team \u0026 Approach\n\n### Team Name\n\n`Team Undefined`\n\n### Team Members\n\n- Jaykumar Patel (Fullstack Dev | The Blockchain Guy | Groq Guy)\n- V Meghashreee (Frontend Lead | Screenpipe Integration | Blockchain Contributor | Backend Bug Hunter)\n- Tejaswini S (Backend Dev)\n- Priyanshi Bhardwaj (AI Specialist)\n\n### Your Approach\n\n- Key challenges included integrating blockchain payments and AI verification.\n- A breakthrough was using Screenpipe's AI for task verification, ensuring trust.\n\n---\n\n## 🛠️ Tech Stack\n\n### Core Technologies Used\n\n- Frontend: React, TypeScript, Tailwind CSS\n- Backend: Hono (Node.js)\n- Database: MongoDB\n- APIs: Groq API, Screenpipe API, Coinbase API\n- Blockchain: Base (Layer 2)\n- Authentication: Wallet-based (Smart-Wallet, Coinbase)\n- Hosting: Render (Frontend), Render (Backend)\n\n### Sponsor Technologies Used\n\n- [✅] **Groq:** Used for AI job recommendations and chatbot.\n- [✅] **Base:** Implemented OnchainKit for wallet connections.\n- [✅] **Screenpipe:** Integrated for screen recording and AI verification.\n\n---\n\n## ✨ Key Features\n\n- ✅ Wallet-based authentication\n- ✅ AI-powered job recommendations\n- ✅ Blockchain-secured payments\n- ✅ AI-driven task verification\n\n---\n\n## 📽️ Demo \u0026 Deliverables\n\n- **Demo Video Link:** [YouTube Link]\n- **Pitch Deck / PPT Link:** [Google Slides Link]\n\n---\n\n## 🧪 Project Setup Instructions\n\n### Prerequisites\n\n- Node.js v18+\n- MongoDB Atlas account\n- Bun (JavaScript runtime and package manager)\n- Foundry (for smart contract development)\n- API Keys:\n  - Groq API\n  - Screenpipe API\n  - Coinbase Platform API\n\n### 1. Backend Setup\n\n```bash\n# Navigate to the backend directory\ncd backend\n\n# Install dependencies\nbun install\n\n# Create .env file with the following variables\ntouch .env\n```\n\nRequired environment variables for backend:\n\n```\n# Required\nMONGODB_URI=mongodb://localhost:27017/peerhire\nJWT_SECRET=your_jwt_secret_key\nJWT_EXPIRATION=7d\n\n# API Keys\nGROQ_API_KEY=your_groq_api_key\nSCREENPIPE_API_KEY=your_screenpipe_api_key\n\n# Optional for demo mode\nDEMO_MODE=true\nDEMO_CLIENT_EMAIL=demo.client@example.com\nDEMO_CLIENT_PASSWORD=demoClient123\nDEMO_FREELANCER_EMAIL=demo.freelancer@example.com\nDEMO_FREELANCER_PASSWORD=demoFreelancer123\n```\n\n```bash\n# Start the backend server\nbun run dev\n```\n\n### 2. Frontend Setup\n\n```bash\n# Navigate to the frontend directory\ncd frontend\n\n# Install dependencies\nbun install\n\n# Create .env file\ntouch .env\n```\n\nRequired environment variables for frontend:\n\n```\nVITE_API_BASE_URL=http://localhost:3000/api\nVITE_COINBASE_APP_ID=your_coinbase_app_id\nVITE_BASE_CHAIN_ID=84532\n```\n\n```bash\n# Start the frontend application\nbun run dev\n```\n\n### 3. Smart Contracts Setup\n\n```bash\n# Navigate to the smart_contracts directory\ncd smart_contracts\n\n# Install Foundry dependencies\nforge install\n\n# Compile contracts\nforge build\n\n# Run tests\nforge test\n\n# Deploy contracts (to local development environment)\nforge script script/Deploy.s.sol --rpc-url http://localhost:8545 --private-key \u003cyour_private_key\u003e\n```\n\nFor Base Sepolia Testnet deployment:\n\n```bash\n# Setup .env file\ntouch .env\n```\n\nRequired environment variables for smart contracts:\n\n```\nPRIVATE_KEY=your_private_key\nBASE_SEPOLIA_RPC_URL=https://sepolia.base.org\nETHERSCAN_API_KEY=your_etherscan_api_key\n```\n\n```bash\n# Deploy to Base Sepolia Testnet\nforge script script/Deploy.s.sol --rpc-url $BASE_SEPOLIA_RPC_URL --private-key $PRIVATE_KEY --verify --etherscan-api-key $ETHERSCAN_API_KEY\n```\n\n### 4. Running the Entire Application\n\n```bash\n# From the root directory\n# Install all dependencies\nbun install\n\n# Start all services concurrently\nbun run dev\n```\n\n---\n\n## 📡 API Integration Details\n\n### Groq AI Integration\n\nThe backend utilizes Groq's LLM API for:\n\n- Job matching and recommendations\n- Skills assessment and verification\n- Intelligent chatbot assistance\n\n### Coinbase OnchainKit Integration\n\nThe frontend integrates with Coinbase's OnchainKit for:\n\n- Wallet authentication\n- Transaction signing\n- Payment processing on Base network\n- Smart contract interaction\n\n### Screenpipe Integration\n\nUsed for:\n\n- Work verification through screen recording\n- AI analysis of work patterns\n- Proof of work validation\n\n---\n\n## 🧬 Future Scope\n\n- 📈 Integration with more blockchains\n- 🛡️ Enhanced security with zero-knowledge proofs\n- 🌐 Support for multiple languages\n\n---\n\n## 📎 Resources / Credits\n\n- APIs: Groq, Screenpipe\n- Libraries: Ethers.js, React Query, OnchainKit\n- Acknowledgements: Thanks to the hackathon organizers and sponsors!\n\n---\n\n## 🏁 Final Words\n\nOur journey was filled with late-night coding sessions and breakthrough moments. We learned a lot about decentralized technologies and are excited to see PeerHire grow!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayptl-me%2Fhackhazards25_peer_hire","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjayptl-me%2Fhackhazards25_peer_hire","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayptl-me%2Fhackhazards25_peer_hire/lists"}