How sivatejachary/vidyamargai works
HireAI is an AI-enabled recruiting and career platform. The principal workflow is a candidate using the web portal, whose requests reach the FastAPI backend for recruitment, resume, and learning capabilities; administrators also have management screens. The tree documents additional agent, job-ingestion, and MCP subsystems. Sampled AI OS engines show model-backed intent and reasoning, but do not establish how the application wires them into API requests. The graph therefore shows the documented web/API boundary and only specific internal or external calls supported by the sampled source.
Main entry points: main.py FastAPI application · client.py Model client · candidate Candidate portal · route.ts API proxy
Components 26
Web experience
- Candidate portal
frontend/app/candidate - Admin portal
frontend/app/admin - API proxy
frontend/app/api/v1/[...slug]/route.ts
Application API
- FastAPI application
backend/app/main.py - Feature routers
backend/app/api/routers - Authentication
backend/app/api/routers/auth.py - Application database
backend/app/core/database.py - File storage
backend/app/services/storage.py
Career capabilities
- Candidate profiles
backend/app/api/routers/profile.py - Resume services
backend/app/api/routers/resume.py - Job agent
backend/app/job_agent - Learning and skills
backend/app/api/routers/learning.py - Career mentoring
backend/app/api/routers/mentor.py - Career chat
backend/app/api/routers/chat.py
AI agent platform
- Agent orchestration
backend/app/services/orchestrator.py - AI OS runtime
backend/ai_os - Intent engine
backend/ai_os/intent_engine/engine.py - Reasoning engine
backend/ai_os/reasoning_engine/engine.py - Job policy
backend/ai_os/policy/policy_engine.py - Human approvals
backend/ai_os/security/approval_engine.py - MCP gateway
backend/app/mcp/gateway.py
External services
- Model client
backend/packages/model_client/client.py - AI model provider
- MinIO storage
Other components
- Candidate
- Administrator
Connections 10
- Candidate → Candidate portal: uses
- Administrator → Admin portal: uses
- Candidate portal → API proxy: sends requests
- API proxy → FastAPI application: forwards requests
- FastAPI application → Feature routers: serves API
- FastAPI application → Application database: uses
- Intent engine → Model client: requests completion
- Reasoning engine → Model client: requests completion
- Model client → AI model provider: calls model
- File storage → MinIO storage: stores files