AI-Powered Job Hunting Copilot - An intelligent agent framework that automates job discovery, analysis, and application processes using OpenManus architecture.
JobPilot-OpenManus combines the power of OpenManus's agent framework with specialized job hunting capabilities, providing a comprehensive solution for modern job seekers.
| Component | Status | Description | | ---------------------------- | ---------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- | | 🏗️ Core Foundation | ✅ Complete | Data models, database layer, type safety | | | 💾 Data Management | ✅ Complete | Job listings, user profiles, applications, companies | | | 👤 User Profiles | ✅ Complete | Full CRUD API, database integration, resume workflow ready | | 🔍 Job Discovery | ✅ Complete | RapidAPI JSearch integration, job extraction, market analysis | | 🧠 Semantic Search | ✅ Complete | AI-powered matching, embeddings, filtering | | 🤖 Basic Agents | ✅ Complete | Job discovery agent with market analysis | | 🧪 Testing Suite | ✅ Complete | FastAPI TestClient, Playwright E2E, pytest integration | | 🌐 Modern Web UI | ✅ Complete | Real-time chat, activity tracking, responsive design | | 🎯 AI Integration | ✅ Complete | JobPilot prompts, transparent AI reasoning | | 📅 Timeline System | ✅ Complete | Job search activity tracking, milestones, events | | 📊 Job Analytics | ✅ Complete | Statistics, insights, progress tracking | | 🔧 Full API Suite | ✅ Complete | REST + WebSocket APIs, health monitoring | | 🔄 ETL Pipeline | ✅ Complete | JSearch API integration, data processing, automated loading | | 🤖 AI Resume Generation | ✅ Complete | LLM-powered content, RenderCV PDFs, multi-format export (94.1% success rate) | | 📊 Additional Job Boards | ⏳ Planned | LinkedIn, Indeed, Glassdoor direct integration | | 📝 Application Tools | ⏳ Planned | Automated form filling and submission | | 📈 Advanced Analytics | ⏳ Planned | Predictive modeling, market trends |
Current Status: ✅ Phase 1 Complete + Phase 2 Bonus Features - Advanced system ready for production Next Phase: 🔄 Real Job Board Integration - See ROADMAP.md for details
JobPilot revolutionizes job hunting by automating tedious tasks while enhancing strategic decision-making. It acts as your personal AI job hunting assistant that works 24/7 to find, analyze, and help you apply to relevant opportunities.
- Job Listings: Full CRUD operations with advanced search and filtering
- User Profiles: Professional information, skills, preferences, and job criteria
- Applications: Track application status, materials, and follow-ups
- Companies: Store and analyze company information and culture
- Robust Database: SQLAlchemy ORM with SQLite/PostgreSQL support
- Real Job Integration: RapidAPI JSearch integration for live job market data
- ETL Pipeline: Complete Extract-Transform-Load system for automated data processing
- Semantic Search: AI understands job requirements beyond keywords using sentence transformers
- Advanced Filtering: Multi-factor scoring based on skills, experience, salary, location, remote work
- Job Market Analysis: Trend analysis, salary insights, top skills and companies
- Company Search: Find all jobs at specific companies
- Demo Mode: Fallback demo job generation for testing and development
- Intelligent Content Creation: AI-powered professional summaries and achievement bullets
- Multi-Provider LLM Support: OpenAI, Anthropic, AWS Bedrock, and Mock providers
- Professional PDF Export: LaTeX-quality resumes via RenderCV integration
- Multi-Format Export: PDF, JSON, YAML, and TXT formats supported
- Template System: 5+ professional resume templates (ModernCV, Classic, Academic, etc.)
- Batch Processing: Generate multiple resume variations simultaneously
- Performance Optimized: Sub-second generation times (0.01-0.03s per resume)
- REST API Integration: Complete FastAPI endpoints for frontend integration
- JobDiscoveryAgent: Specialized agent for job hunting workflows
- Market Analysis: Automated job market trend reporting
- Integration Ready: Built on OpenManus agent framework for extensibility
- Type Safety: Full Pydantic validation throughout
- Repository Pattern: Clean separation of data access logic
- Comprehensive Testing: All core components tested and validated
- Extensible Design: Easy to add new job boards, tools, and agents
- Production Ready: Proper error handling, logging, and session management
JobPilot-OpenManus is built on top of the robust OpenManus framework with job-specific enhancements:
JobPilot-OpenManus/
├── app/
│ ├── agent/
│ │ ├── job_discovery.py # ✅ Job search and extraction agent
│ │ ├── manus.py # ✅ Core OpenManus agent
│ │ ├── browser.py # ✅ Browser automation agent
│ │ └── [other agents] # ✅ Data analysis, SWE, etc.
│ ├── tool/
│ │ ├── job_scraper/ # ✅ Demo job generation tool
│ │ ├── semantic_search/ # ✅ AI-powered job matching
│ │ ├── browser_use_tool.py # ✅ Browser automation
│ │ └── [standard tools] # ✅ File ops, Python, search, etc.
│ ├── data/
│ │ ├── models.py # ✅ JobListing, UserProfile models
│ │ └── database.py # ✅ SQLAlchemy repository layer
│ ├── prompt/
│ │ └── jobpilot.py # ✅ JobPilot-specific prompts
│ └── [OpenManus core] # ✅ LLM, config, logging, etc.
├── frontend/
│ ├── src/
│ │ ├── components/ # ✅ Modern Solid.js UI components
│ │ ├── services/ # ✅ WebSocket and API services
│ │ └── [Solid.js app] # ✅ Real-time chat interface
│ └── dist/ # ✅ Built frontend assets
├── tests/
│ ├── backend/
│ │ ├── api/ # ✅ FastAPI endpoint tests
│ │ ├── database/ # ✅ Database integration tests
│ │ ├── etl/ # ✅ ETL pipeline tests
│ │ └── models/ # ✅ Data model tests
│ ├── e2e/
│ │ ├── tests/ # ✅ End-to-end test cases
│ │ ├── fixtures/ # ✅ Test data and setup
│ │ ├── pages/ # ✅ Page object models
│ │ └── utils/ # ✅ E2E test utilities
│ ├── utils/
│ │ ├── test_server.py # ✅ Server lifecycle management
│ │ ├── test_data.py # ✅ Test data generators
│ │ └── fixtures.py # ✅ Shared test fixtures
│ ├── conftest.py # ✅ Pytest configuration
│ ├── test_core_components.py # ✅ Legacy core functionality tests
│ └── test_jobpilot_migration.py # ✅ Migration validation
├── web_server.py # ✅ FastAPI + WebSocket server
├── assets/ # ✅ JobPilot icons and images
└── config/
└── config.example.toml # ✅ Configuration templates
- Python 3.12+
- Local LLM (Ollama recommended) or OpenAI/Claude API access
- Clone the repository:
git clone https://github.com/alexretana/JobPilot-OpenManus.git
cd JobPilot-OpenManus- Create virtual environment:
python -m venv venv
source venv/bin/activate # On Unix/macOS
# Or on Windows:
# venv\Scripts\activate- Install dependencies:
pip install -r requirements.txt
playwright install # For browser automationOpenManus requires configuration for the LLM APIs it uses. Follow these steps to set up your configuration:
- Create a
config.tomlfile in theconfigdirectory (you can copy from the example):
cp config/config.example.toml config/config.toml- Edit
config/config.tomlto add your API keys and customize settings:
# Global LLM configuration
[llm]
model = "gpt-4o"
base_url = "https://api.openai.com/v1"
api_key = "sk-..." # Replace with your actual API key
max_tokens = 4096
temperature = 0.0
# Optional configuration for specific LLM models
[llm.vision]
model = "gpt-4o"
base_url = "https://api.openai.com/v1"
api_key = "sk-..." # Replace with your actual API key- Set up JSearch API (Optional): For real job data integration, add your RapidAPI key as an environment variable:
# Add to your environment (e.g., .env file)
RAPIDAPI_KEY=your_rapidapi_key_hereNote: Without the RapidAPI key, the system will use demo job data for testing. Get your key from RapidAPI JSearch.
One line for run OpenManus:
python main.pyThen input your idea via terminal!
For MCP tool version, you can run:
python run_mcp.pyFor unstable multi-agent version, you also can run:
python run_flow.pyCurrently, besides the general OpenManus Agent, we have also integrated the DataAnalysis Agent, which is suitable for
data analysis and data visualization tasks. You can add this agent to run_flow in config.toml.
# Optional configuration for run-flow
[runflow]
use_data_analysis_agent = true # Disabled by default, change to true to activateIn addition, you need to install the relevant dependencies to ensure the agent runs properly: Detailed Installation Guide
JobPilot-OpenManus features a modern, responsive web interface built with Solid.js, TailwindCSS, and DaisyUI for seamless interaction with the job hunting agent.
🚀 Easy Development Mode (Recommended)
Windows:
start.batLinux/macOS:
./start.shThe startup scripts will:
- ✅ Validate all dependencies (Node.js, npm, Python)
- ✅ Install frontend dependencies if needed
- ✅ Build the frontend for production if not already built
- ✅ Start the backend server on port 8080
- ✅ Start the frontend dev server on port 3000
- ✅ Open both services in separate shells/windows
Manual Setup:
-
Build the frontend (first time only):
cd frontend npm install npm run build cd ..
-
Start the web server:
python web_server.py
-
Open your browser to
http://localhost:8080
- 🎨 Modern UI: Built with Solid.js, TailwindCSS, and DaisyUI
- 🔄 Real-time Chat: WebSocket-based communication with the AI agent
- 🌐 Live Browser Viewport: Watch the agent browse job sites in real-time
- 📊 Activity Dashboard: Track all agent actions, tool usage, and reasoning
- 📈 Progress Tracking: Visual progress indicators for long-running searches
- 🎯 Quick Actions: Pre-built queries for common job search tasks
- 🎭 29+ Themes: Switch between light, dark, and specialty themes
- 📱 Responsive Design: Works perfectly on desktop, tablet, and mobile
- 🔍 Transparent AI: Full visibility into the agent's decision-making process
- ⚡ Fast & Modern: Vite-powered development with hot reload
- Frontend:
http://localhost:3000(development with hot reload) - Backend API:
http://localhost:8080(production build served here) - API Health Check:
http://localhost:8080/api/health
See frontend/README.md for detailed frontend documentation.
- Backend: FastAPI server with WebSocket support
- Frontend: Solid.js SPA with reactive state management
- Styling: TailwindCSS + DaisyUI component library
- Build: Vite for fast builds and development
- Types: Full TypeScript support throughout
JobPilot-OpenManus includes a professional-grade testing infrastructure that provides confidence in code changes and catches regressions early.
- 🚀 Fast Backend Tests: FastAPI TestClient for rapid API validation (3.7s for 29 tests)
- 🎭 End-to-End Tests: Playwright browser automation with full workflow testing
- ⚡ Performance Tests: Response time validation and load testing
- 🔒 Security Tests: SQL injection protection and malformed input handling
- 🔄 Integration Tests: Complete user journey validation from API to UI
- 📊 Coverage Reports: HTML and terminal coverage reporting
Run Fast Backend Tests (Recommended for daily development):
python run_tests.py --backend # Fast API tests (~4s)
python run_tests.py --backend -v # Verbose output
python run_tests.py -k test_health # Specific testsRun Comprehensive E2E Tests (Before major releases):
python run_tests.py --e2e # Full E2E suite with Playwright
python run_tests.py --e2e --rapidapi-key YOUR_KEY # With real API testingTargeted Testing:
python run_tests.py --performance # Performance tests only
python run_tests.py --integration # Integration tests only
python run_tests.py --all # All tests except E2E
python run_tests.py --backend --cov # With coverage report| Test Type | Purpose | Speed | Coverage |
|---|---|---|---|
| Backend API | FastAPI endpoints, CRUD operations | ⚡ Fast (3-5s) | Core API functionality |
| Integration | Multi-component workflows | 🚀 Medium (10-30s) | Component interactions |
| End-to-End | Full user journeys with UI | 🎭 Comprehensive (1-3min) | Complete workflows |
| Performance | Response times, load testing | ⚡ Fast (5-10s) | System performance |
| Security | Input validation, injection protection | 🔒 Medium (5-15s) | Security vulnerabilities |
- ✅ Breaking Change Detection: Tests fail when APIs change unexpectedly
- ✅ Performance Monitoring: Validate response times stay under thresholds
- ✅ Security Validation: Test protection against malicious inputs
- ✅ Database Integrity: Verify data persistence and consistency
- ✅ Browser Automation: Real UI testing with Playwright
- ✅ CI/CD Ready: JUnit XML, HTML reports, proper exit codes
🧪 JobPilot-OpenManus Test Runner
🚀 Running Fast Backend API Tests (FastAPI TestClient)
======================= 13 passed, 16 skipped, 29 warnings in 3.70s =======================
🎉 All tests passed!
Test Coverage: 13 core API tests passing, comprehensive validation of:
- Health endpoints and basic API functionality
- Job CRUD operations (Create, Read, Update, Delete)
- Error handling and security protection
- Performance characteristics and response times
For detailed testing documentation, see TESTING.md.
We welcome any friendly suggestions and helpful contributions! Just create issues or submit pull requests.
Or contact @mannaandpoem via 📧email: mannaandpoem@gmail.com
Note: Before submitting a pull request, please use the pre-commit tool to check your changes. Run
pre-commit run --all-files to execute the checks.
Thanks to anthropic-computer-use and browser-use for providing basic support for this project!
Additionally, we are grateful to AAAJ, MetaGPT, OpenHands and SWE-agent.
We also thank stepfun(阶跃星辰) for supporting our Hugging Face demo space.
OpenManus is built by contributors from MetaGPT. Huge thanks to this agent community!
@misc{openmanus2025,
author = {Xinbin Liang and Jinyu Xiang and Zhaoyang Yu and Jiayi Zhang and Sirui Hong and Sheng Fan and Xiao Tang},
title = {OpenManus: An open-source framework for building general AI agents},
year = {2025},
publisher = {Zenodo},
doi = {10.5281/zenodo.15186407},
url = {https://doi.org/10.5281/zenodo.15186407},
}