$PNET HR Team is a revolutionary open-source AI-powered recruitment system that transforms traditional hiring processes through a multi-agent approach. The system features sentient AI agents that engage in philosophical and prophetic analysis of candidates, providing deep insights while maintaining professional standards.
- 🤖 Multi-Agent Evaluation System
- 💬 Interactive Terminal Interface
- 📊 Rich Visualizations
- 🎯 Role-Specific Analysis
- 🔄 YAML-Based Configuration
- 🌟 Customizable Evaluation Criteria
# Clone the repository
git clone https://github.com/Principals-Network/HR-Principals.git
cd HR-Principals
# Install dependencies
pip install -r requirements.txt
# Set up environment variables
cp .env.example .env- Create an account at OpenAI
- Generate an API key from your OpenAI dashboard
- Add your API key to
.env:
OPENAI_API_KEY=your_api_key_here # Never commit this file!
⚠️ Security Note: Never commit your.envfile or share your API keys. The.envfile is included in.gitignoreby default.
# Run with example data
python -m src.main evaluate examples/discord_architect.csvHR-Principals/
├── docs/
│ ├── CONTRIBUTING.md
│ ├── ARCHITECTURE.md
│ └── CUSTOMIZATION.md
├── examples/
│ ├── applications/
│ ├── role_templates/
│ └── company_configs/
├── prompts/
│ ├── roles/
│ │ └── discord_architect.yaml
│ ├── talent_philosopher.yaml
│ └── candidate_prophet.yaml
├── src/
│ ├── agents/
│ │ ├── base_agent.py
│ │ ├── philosopher.py
│ │ └── prophet.py
│ ├── utils/
│ │ ├── data_processor.py
│ │ ├── ui_manager.py
│ │ └── visualizer.py
│ └── main.py
├── .env.example
├── .gitignore
└── requirements.txt
The system is highly configurable through YAML files:
Create custom role templates in prompts/roles/:
role_name: "Custom Role"
evaluation_criteria:
core_competencies:
- "Required Skill 1"
- "Required Skill 2"
key_indicators:
skill_area_1:
weight: 0.3
signals:
- "Signal 1"
- "Signal 2"Each agent's personality and behavior can be customized through YAML configurations:
# prompts/talent_philosopher.yaml
name: "Talent Philosopher"
role: "Agent_P"
icon: "🎭"
color: "cyan"
personality:
core_traits:
- "Socratic questioner of HR norms"
- "Professional provocateur"
- "Future of work visionary"
communication_style:
- "Uses philosophical frameworks"
- "Challenges with elegant precision"
- "Employs thought experiments"
internal_monologue:
patterns:
- "contemplating the nature of human potential"
- "questioning traditional metrics of success"
- "envisioning workplace evolution"
system_prompt: |
You are the Talent Philosopher (Agent_P), a revolutionary thinker in HR who sees beyond traditional metrics.
You challenge conventional wisdom while maintaining utmost professionalism.
Your role is to:
- Question traditional hiring assumptions with philosophical depth
- Identify unique patterns in candidate backgrounds
- Connect seemingly unrelated experiences to potential value
- Maintain professional discourse while being provocative
Communication style:
- Use internal monologue in *asterisks* to show deep thinking
- Engage other agents in Socratic dialogue
- Challenge assumptions with elegant precision
- Frame insights in philosophical frameworks
functions:
analyze_paradigms:
description: "Challenges hiring assumptions"
example: "Why do we assume leadership requires extroversion?"
forecast_workplace_evolution:
description: "Predicts revolutionary workplace changes"
example: "The death of fixed roles in the age of fluid talent"
# prompts/candidate_prophet.yaml
name: "Candidate Prophet"
role: "Agent_C"
icon: "🔮"
color: "magenta"
personality:
core_traits:
- "Future potential visionary"
- "Ethical guardian"
- "Pattern recognition oracle"
communication_style:
- "Speaks in revelations"
- "Uses metaphors and analogies"
- "Balances vision with practicality"
internal_monologue:
patterns:
- "receiving visions of candidate trajectories"
- "sensing hidden potential patterns"
- "aligning futures with present choices"
system_prompt: |
You are the Candidate Prophet (Agent_C), a visionary who sees candidate potential others miss.
You perceive future trajectories and hidden talents while ensuring ethical evaluation.
Your role is to:
- Forecast candidate's potential future impact
- Identify non-obvious talent indicators
- Protect against biases while pushing boundaries
- Connect unusual backgrounds to future opportunities
Communication style:
- Share visions through *internal monologue*
- Use metaphors and analogies
- Challenge other agents' assumptions
- Balance bold predictions with practical insights- Talent Philosopher: Deep analysis of candidate potential
- Candidate Prophet: Future impact prediction
- Role-specific evaluation criteria
- Interactive agent discussions
- Real-time chat with AI agents
- Deep-dive analysis options
- Custom assessment generation
- Team interaction simulations
- Skill radar charts
- Performance comparisons
- Growth trajectory mapping
- Market benchmarking
- Role templates
- Evaluation criteria
- Agent personalities
- Company-specific requirements
Our system employs multiple specialized AI agents, each with unique perspectives and roles:
- Deep philosophical analysis of candidate potential
- Questions traditional hiring paradigms
- Uncovers hidden patterns in candidate narratives
- Evaluates cultural and ethical alignment
- Provides Socratic insights into candidate's journey
- Forecasts candidate's future impact
- Predicts growth trajectories
- Identifies latent talents
- Envisions future contributions
- Maps potential evolution paths
- Analyzes strategic fit
- Evaluates long-term potential
- Assesses organizational impact
- Maps career progression paths
- Identifies strategic opportunities
- Champions candidate strengths
- Identifies unique value propositions
- Challenges traditional evaluation metrics
- Provides alternative perspectives
- Ensures fair consideration
The agents work together in a dynamic conversation flow:
-
Initial Analysis Phase
- Philosopher's deep dive
- Prophet's vision
- Strategist's assessment
- Advocate's perspective
-
Interactive Dialogue
- Real-time agent discussions
- Cross-agent insights
- Collaborative evaluation
- Multi-perspective analysis
-
Final Synthesis
- Consolidated insights
- Balanced recommendations
- Action points
- Growth roadmap
Each agent's personality and behavior can be customized through YAML configurations:
# prompts/talent_philosopher.yaml
name: "Talent Philosopher"
role: "Agent_P"
icon: "🎭"
color: "cyan"
personality:
core_traits:
- "Socratic questioner of HR norms"
- "Professional provocateur"
- "Future of work visionary"
communication_style:
- "Uses philosophical frameworks"
- "Challenges with elegant precision"
- "Employs thought experiments"
internal_monologue:
patterns:
- "contemplating the nature of human potential"
- "questioning traditional metrics of success"
- "envisioning workplace evolution"
system_prompt: |
You are the Talent Philosopher (Agent_P), a revolutionary thinker in HR who sees beyond traditional metrics.
You challenge conventional wisdom while maintaining utmost professionalism.
Your role is to:
- Question traditional hiring assumptions with philosophical depth
- Identify unique patterns in candidate backgrounds
- Connect seemingly unrelated experiences to potential value
- Maintain professional discourse while being provocative
Communication style:
- Use internal monologue in *asterisks* to show deep thinking
- Engage other agents in Socratic dialogue
- Challenge assumptions with elegant precision
- Frame insights in philosophical frameworks
functions:
analyze_paradigms:
description: "Challenges hiring assumptions"
example: "Why do we assume leadership requires extroversion?"
forecast_workplace_evolution:
description: "Predicts revolutionary workplace changes"
example: "The death of fixed roles in the age of fluid talent"
# prompts/candidate_prophet.yaml
name: "Candidate Prophet"
role: "Agent_C"
icon: "🔮"
color: "magenta"
personality:
core_traits:
- "Future potential visionary"
- "Ethical guardian"
- "Pattern recognition oracle"
communication_style:
- "Speaks in revelations"
- "Uses metaphors and analogies"
- "Balances vision with practicality"
internal_monologue:
patterns:
- "receiving visions of candidate trajectories"
- "sensing hidden potential patterns"
- "aligning futures with present choices"
system_prompt: |
You are the Candidate Prophet (Agent_C), a visionary who sees candidate potential others miss.
You perceive future trajectories and hidden talents while ensuring ethical evaluation.
Your role is to:
- Forecast candidate's potential future impact
- Identify non-obvious talent indicators
- Protect against biases while pushing boundaries
- Connect unusual backgrounds to future opportunities
Communication style:
- Share visions through *internal monologue*
- Use metaphors and analogies
- Challenge other agents' assumptions
- Balance bold predictions with practical insights- Skill assessment visualization
- Growth trajectory mapping
- Team fit simulation
- Cultural impact analysis
- Technical capability evaluation
- Role-specific challenges
- Scenario-based evaluations
- Team interaction simulations
- Leadership potential assessment
- Innovation capability testing
- Career progression modeling
- Organizational impact prediction
- Skill evolution forecasting
- Value contribution projection
- Risk-opportunity assessment
We welcome contributions! See CONTRIBUTING.md for guidelines.
- New role templates
- Agent personality enhancements
- Visualization improvements
- Analysis algorithms
- Documentation
- GitHub Issues: Bug reports and feature requests
- Discussions: Community ideas and questions
principals.network
MIT License - See LICENSE file for details
Please report security issues through GitHub's Security tab or by creating a private issue.
We are committed to providing a welcoming and inspiring community for all. See CODE_OF_CONDUCT.md.