'/%3e%3c!--%20Subtle%20grid%20lines%20showing%20assembly%20--%3e%3cline%20x1='64'%20y1='20'%20x2='64'%20y2='108'%20stroke='%234c1d95'%20stroke-width='0.5'%20opacity='0.2'/%3e%3cline%20x1='20'%20y1='64'%20x2='108'%20y2='64'%20stroke='%234c1d95'%20stroke-width='0.5'%20opacity='0.2'/%3e%3c!--%20Piece%201:%20Top-left%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='24'%20y='24'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p1)'%20opacity='0.9'%20transform='translate(-2,%20-2)'/%3e%3c!--%20Piece%202:%20Top-right%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='68'%20y='24'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p2)'%20opacity='0.85'%20transform='translate(2,%20-2)'/%3e%3c!--%20Piece%203:%20Bottom-left%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='24'%20y='68'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p3)'%20opacity='0.8'%20transform='translate(-2,%202)'/%3e%3c!--%20Piece%204:%20Bottom-right%20—%20slightly%20offset%20outward%20--%3e%3crect%20x='68'%20y='68'%20width='36'%20height='36'%20rx='6'%20fill='url(%23p4)'%20opacity='0.85'%20transform='translate(2,%202)'/%3e%3c!--%20Connector%20glow%20at%20center%20where%20pieces%20almost%20meet%20--%3e%3ccircle%20cx='64'%20cy='64'%20r='8'%20fill='%23fff'%20opacity='0.15'/%3e%3ccircle%20cx='64'%20cy='64'%20r='4'%20fill='%23c4b5fd'%20opacity='0.4'/%3e%3c!--%20Edge%20highlights%20—%20light%20seams%20between%20pieces%20--%3e%3cline%20x1='62'%20y1='26'%20x2='62'%20y2='58'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='66'%20y1='26'%20x2='66'%20y2='58'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='62'%20y1='70'%20x2='62'%20y2='102'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='66'%20y1='70'%20x2='66'%20y2='102'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='26'%20y1='62'%20x2='58'%20y2='62'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='26'%20y1='66'%20x2='58'%20y2='66'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='70'%20y1='62'%20x2='102'%20y2='62'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3cline%20x1='70'%20y1='66'%20x2='102'%20y2='66'%20stroke='%23c4b5fd'%20stroke-width='0.8'%20opacity='0.3'/%3e%3c!--%20Floating%20accent%20particles%20--%3e%3ccircle%20cx='18'%20cy='18'%20r='1.2'%20fill='%23a78bfa'%20opacity='0.5'/%3e%3ccircle%20cx='110'%20cy='18'%20r='1'%20fill='%23818cf8'%20opacity='0.4'/%3e%3ccircle%20cx='110'%20cy='110'%20r='1.2'%20fill='%23c4b5fd'%20opacity='0.45'/%3e%3ccircle%20cx='18'%20cy='110'%20r='1'%20fill='%23ddd6fe'%20opacity='0.4'/%3e%3c/svg%3e){kind=small}
Talent scout
Run a local scouting workflow that searches Markidy profiles and evaluates each person against your scouting goal using their public profile introduction, career history, recruiting preferences, social links, and trust links.
Watch demo
See the full flow from setup to saved scouting report before installing the workflow.
Overview
Talent scout is an open-source local app for recruiters, founders, and hiring managers. It uses the Markidy API to find public profiles, then reviews each candidate against your scouting goal using structured profile signals, including bio, career history, recruiting preferences, social links, and trust links.
Talent scout does not just match keywords. It evaluates public profile signals such as a person's introduction, career history, recruiting preferences, social links, and trust links against your scouting goal.
The workflow is designed for sourcing assistance. It does not send messages, run chats, or make automated employment decisions.
Requirements
| Item | Required | Notes |
|---|---|---|
| Node.js | Yes | Use Node.js 20.19+ or 22.12+. |
| Markidy API key | Yes | Create one from API Keys. |
| AI provider key | Yes | OpenAI, Anthropic Claude, Google Gemini, xAI Grok, or Mistral AI. |
Quick start
Clone the repository, then use the launcher for your OS or run the terminal commands manually.
git clone https://github.com/Team-Daco-V3/talent-scout.git
cd talent-scoutOption 1: launcher
start-talent-scout-windows.cmdchmod +x start-talent-scout-macos-linux.sh
./start-talent-scout-macos-linux.shOption 2: terminal
npm install
npm run startOn Windows PowerShell, use npm.cmd if script execution
blocks the regular npm command.
npm.cmd install
npm.cmd run startThe local app starts at http://localhost:17300. Stop the
server with Ctrl+C in the terminal.
First run
- Open
http://localhost:17300. - Keep the default Markidy API URL:
https://api.markidy.com. - Paste your Markidy API key.
- Choose an AI provider and paste that provider's API key.
- Create or edit a scout with the goal, target role, required skills, location or work conditions, and candidate count.
- Save the scout, then run it.
- Open Reports to review saved and in-progress results.
Reports and security
Completed runs are saved as JSON files in the local project reports folder. Existing reports are not overwritten, and API keys are not written into report files.