AI-HR

by one-zero-eight

https://hr.innohassle.ru/

💡 Idea

The project is an automated recruitment system powered by artificial intelligence. Its goal is to reduce the time required for hiring and minimize subjectivity in the decision-making process. The AI pipeline includes resume analysis and a voice-based interview with the candidate.

🔧 Tech Stack

🚀 How to Run the Project

Development Mode

Backend

1. Go to the backend folder:

cd backend

2. Install dependencies:

uv sync

3. Copy and configure settings:

cp settings.example.yaml settings.yaml

Edit settings.yaml according to your environment (see settings.schema.yaml for details).

4. Start Postgres and Unoserver:

docker compose up db unoserver

5. Start the backend server:

cd backend
uv run -m src.api --reload

Note: For endpoints requiring authorization, use the Authorize button in Swagger UI.

Frontend

1. Go to the frontend folder:

cd frontend

2. Install dependencies:

pnpm install

3. Start the frontend development server:

pnpm start

Production Mode

Backend / Server

1. Go to the backend folder:

cd backend

2. Copy the settings:

cp settings.example.yaml settings.yaml

3. Adjust settings.yaml for production (refer to settings.schema.yaml ).

Note: make sure to change db_url and unoserver_server from localhost/127.0.0.1 to the service names db and unoserver.

4. Build and start the services:

docker compose up --build -d

Frontend

1. Go to the frontend folder:

cd frontend

2. Make .env file

cp .env.example .env

3. Build the frontend:

pnpm build

4. Serve the frontend (e.g., via Nginx or any static file server)

🧩 Components

Name	Description	More Info
Frontend	React interface providing voice interaction	📄 frontend/README.md
Backend	FastAPI backend with REST API and integration with external AI APIs	📄 backend/README.md

👥 Team members

one-zero-eight team

Team member	Contribution
ZolotarevAlexandr	Backend + ML: architecture and external APIs
Stillah	Backend: creating endpoints
belyakova-anna	Frontend: page design and development
projacktor	DevOps: project deployment