Instalação | Resume Matcher

Pré-requisitos

Python 3.13+
Node.js 22+
uv
npm

Instale o uv com:

curl -LsSf https://astral.sh/uv/install.sh | sh

Configuração para desenvolvimento local

Clone o repositório principal do app Resume Matcher e depois inicie o backend e o frontend em terminais separados.

git clone https://github.com/srbhr/Resume-Matcher.git
cd Resume-Matcher

# Terminal 1
cd apps/backend
cp .env.example .env
uv sync
uv run app

# Terminal 2
cd apps/frontend
npm install
npm run dev

URLs locais padrão

Frontend: http://localhost:3000
Backend: http://127.0.0.1:8000

O frontend espera o backend em http://127.0.0.1:8000 por padrão.

Playwright para exportar PDF

A geração de PDF depende do Playwright e do Chromium. Depois de instalar as dependências do backend, rode:

cd apps/backend
python -m playwright install chromium

Sem esse passo, a exportação de PDF vai falhar.

Observações

npm install em apps/frontend instala só as dependências do frontend.
No desenvolvimento local, o frontend e o backend sobem separados.
Configure seu provedor de IA no app depois que os dois servidores estiverem rodando.
Os provedores suportados incluem OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Groq, Azure AI Foundry, Ollama e servidores compatíveis com a API da OpenAI. Veja Traga sua própria chave de IA.

Solução de problemas

uv não encontrado

Instale com:

curl -LsSf https://astral.sh/uv/install.sh | sh

Versão errada do Python

Verifique:

python --version

O desenvolvimento local do Resume Matcher exige Python 3.13+.

O frontend não alcança a API

Confira se o backend está rodando em http://127.0.0.1:8000.

A exportação de PDF falha

Rode de novo:

python -m playwright install chromium