AI-powered job application automation. Upload your resume once — JobHuntin matches, tailors, and auto-applies to hundreds of jobs daily.
- Development Guide — Local setup, environment, running services
- Architecture — System design, components, data flow
- Documentation Index — Full doc map
git clone <repo-url> && cd jobhuntin
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt && npm install
cp .env.example .env # Configure DATABASE_URL, JWT_SECRET, CSRF_SECRET, etc.
docker compose up db -d
PYTHONPATH=apps:packages:. uvicorn api.main:app --reload --host 0.0.0.0 --port 8000
cd apps/web && npx vite --host 0.0.0.0 --port 5173
# Optional: Admin Dashboard
cd apps/web-admin && npx vite --host 0.0.0.0 --port 5174| Command | Purpose |
|---|---|
make dev-backend |
Run FastAPI backend |
make dev-web |
Run web app |
make test-backend |
Run Python tests |
cd apps/web && npm run build |
Build web app |
- Investor Overview — Metrics API, data room endpoints
- investor-metrics/ — Core metrics export
- investor-data-room/ — Full diligence package
├── apps/
│ ├── api/ FastAPI backend
│ ├── web/ Vite/React consumer app
│ ├── web-admin/ Operator dashboard
│ ├── extension/ Chrome extension
│ └── worker/ Playwright automation (FormAgent)
├── packages/
│ ├── backend/ Domain, repositories, LLM
│ └── blueprints/ Job board adapters
├── shared/ Config, logging, telemetry
├── infra/ Database schema, migrations
├── docs/ Documentation
└── scripts/ Maintenance, migrations, load tests
- Render — Production (PostgreSQL, Redis, API, worker, web)
- Setup — See docs/RENDER_SETUP.md
See CONTRIBUTING.md for workflow, quality gates, and standards.
See SECURITY.md for dependency advisories and remediation.
Proprietary. All rights reserved.