Documentação

Instalação

Rode o Resume Matcher a partir do código-fonte, sem Docker: Python 3.13+ e uv no backend, Node.js 22+ e npm no frontend, cada um no seu terminal.

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.

O Resume Matcher se mantém com doações.

Mais de 200 mil pessoas em busca de emprego já usaram, de graça, sem anúncios nem paywall. Se ele te poupou tempo ou ajudou você a conseguir uma entrevista, patrocinar ou me pagar um café mantém tudo assim.

Patrocinar no GitHub Me pague um café Estrela no GitHub28k+

Playwright para exportar PDF

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

cd apps/backend
uv run playwright install chromium

Sem esse passo, a exportação de PDF só funciona se o Chrome ou o Edge estiver instalado na máquina, já que o app recorre a eles como alternativa.

A exportação de PDF também precisa do frontend rodando, porque o Chromium imprime a página de impressão do frontend.

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 em http://localhost:3000/settings depois que os dois servidores estiverem rodando.
  • Seus dados vão para um banco SQLite em apps/backend/data/, que não precisa de configuração. Para usar PostgreSQL em vez dele, veja Use PostgreSQL em vez de SQLite.
  • Os provedores suportados incluem OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Groq, Azure AI Foundry, Ollama e servidores compatíveis com a API da OpenAI, além do seu plano do ChatGPT ou do Claude. 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

Confira se o frontend está rodando e rode de novo a partir de apps/backend:

uv run playwright install chromium

Próximos passos

Voltar para a documentação