Skip to content
Back to search

latexresume

Open-source LaTeX resume builder with AI assistant and MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/adhi2624--latexresume/badge.svg)](/listings/adhi2624--latexresume)

HTML

<a href="/listings/adhi2624--latexresume"><img src="/api/listings/adhi2624--latexresume/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements: Node 20.9+, [pnpm](https://pnpm.io) 9 (`corepack enable`), Docker.

pnpm install
cp .env.example .env.local        # then set JWT_SECRET and ENCRYPTION_SECRET (openssl rand -base64 48)
pnpm services                     # MongoDB Community + LaTeX compiler (docker compose --env-file .env.local up -d)
pnpm dev                          # http://localhost:3000

Already running MongoDB on 27017? Use `docker compose up -d compiler`, or change the host port with `MONGO_PORT=27018 docker compose up -d` and update `MONGODB_URI`.

Create an account at `/auth/signup`, pick a template, press **Compile**.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 112 lines
  1. # LaTeXResume
  2. An open-source, self-hostable **LaTeX resume builder** with live PDF preview, an **AI assistant**
  3. (bring your own key) and a built-in **MCP server**. Run it locally with Docker, or deploy it to
  4. **Cloudflare Workers** with **MongoDB Atlas**.
  5. - ✍️ Monaco editor + real TeX Live compilation (your resume is just a `.tex` file)
  6. - 🤖 AI chat with OpenAI, Anthropic or any OpenAI-compatible endpoint (Ollama, OpenRouter, vLLM…); keys are stored AES-GCM encrypted
  7. - 🔌 MCP server at `/mcp` — let Claude, Cursor, etc. list, edit, compile and publish resumes
  8. - 🔗 Publish a resume to a public URL (and unpublish)
  9. - 🪶 No plans, billing or tracking. MIT licensed.
  10. ## Architecture
  11. ```
  12. Browser ──► Next.js app (Node, or Cloudflare Worker via OpenNext) ──► MongoDB (Community locally / Atlas in prod)
  13. │
  14. └──► LaTeX compiler service (Docker, TeX Live) ← Workers cannot run TeX
  15. ```
  16. Workers can't execute `pdflatex`, so compilation lives in a small separate service (`compiler/`).
  17. Run it with Docker anywhere (Fly.io, Railway, a VPS, Cloud Run, Cloudflare Containers…) and point
  18. `LATEX_COMPILER_URL` at it.
  19. ## Quick start (local)
  20. Requirements: Node 20.9+, [pnpm](https://pnpm.io) 9 (`corepack enable`), Docker.
  21. ```bash
  22. pnpm install
  23. cp .env.example .env.local # then set JWT_SECRET and ENCRYPTION_SECRET (openssl rand -base64 48)
  24. pnpm services # MongoDB Community + LaTeX compiler (docker compose --env-file .env.local up -d)
  25. pnpm dev # http://localhost:3000
  26. ```
  27. Already running MongoDB on 27017? Use `docker compose up -d compiler`, or change the host port with
  28. `MONGO_PORT=27018 docker compose up -d` and update `MONGODB_URI`.
  29. Create an account at `/auth/signup`, pick a template, press **Compile**.
  30. ## Configuration
  31. | Variable | Required | Description |
  32. | --- | --- | --- |
  33. | `MONGODB_URI` | ✅ | Connection string; the database name comes from the path (`…/latexresume`). |
  34. | `JWT_SECRET` | ✅ | ≥16 chars; signs session cookies. `openssl rand -base64 48` |
  35. | `ENCRYPTION_SECRET` | ✅ | Encrypts users' stored AI API keys. |
  36. | `LATEX_COMPILER_URL` | ✅ | URL of the compiler service. |
  37. | `LATEX_COMPILER_TOKEN` | – | Shared secret (the compiler's `AUTH_TOKEN`). |
  38. | `ALLOW_SIGNUP` | – | `false` closes registration (recommended for personal instances). |
  39. | `OPENAI_API_KEY` | – | Server-wide default AI key; users may bring their own. |
  40. | `NEXT_PUBLIC_REPO_URL` | – | Shows GitHub links in the UI (**build time** — set it when running `pnpm build`/`pnpm deploy`). |
  41. | `ALLOW_PRIVATE_AI_URLS` | – | Production only: allow loopback/private AI base URLs (blocked by default to prevent SSRF). |
  42. | `RATE_LIMIT_SCALE` | – | Multiplier for built-in rate limits (default `1` in production, `100` in development). |
  43. | `TRUST_PROXY` | – | Set `true` only behind a reverse proxy that sets `X-Forwarded-For`; otherwise per-IP limits share one bucket. |
  44. | `ALLOW_CUSTOM_AI_URLS` | – | `false` disables user-supplied AI base URLs entirely (recommended on shared hosts). |
  45. Compiler service (`compiler/`) variables: `PORT` (9000), `AUTH_TOKEN`, `COMPILE_TIMEOUT_MS` (30000), `MAX_CONCURRENT` (2).
  46. **Never expose the compiler publicly without `AUTH_TOKEN`** — it executes TeX on behalf of callers.
  47. ## Deploy
  48. - **Vercel (app) + Render (compiler) + MongoDB Atlas:** see **[docs/DEPLOY-VERCEL-RENDER.md](docs/DEPLOY-VERCEL-RENDER.md)**.
  49. - **Cloudflare Workers + MongoDB Atlas:** below.
  50. ### Cloudflare Workers + MongoDB Atlas
  51. See **[docs/DEPLOY-CLOUDFLARE.md](docs/DEPLOY-CLOUDFLARE.md)**. In short:
  52. ```bash
  53. pnpm db:init # once, creates indexes (against Atlas)
  54. npx wrangler secret put MONGODB_URI # standard (non-SRV) Atlas string!
  55. npx wrangler secret put JWT_SECRET
  56. npx wrangler secret put ENCRYPTION_SECRET
  57. npx wrangler secret put LATEX_COMPILER_URL
  58. pnpm deploy
  59. ```
  60. ## MCP server
  61. Create an API token in **Settings → API tokens & MCP**, then add the server to your client:
  62. ```json
  63. { "mcpServers": { "latexresume": { "type": "http", "url": "https://YOUR-HOST/mcp",
  64. "headers": { "Authorization": "Bearer lrp_…" } } } }
  65. ```
  66. Tools: `list_templates`, `list_resumes`, `get_resume`, `create_resume`, `update_resume`,
  67. `delete_resume`, `compile_resume`, `publish_resume`, `unpublish_resume`. Details in [docs/MCP.md](docs/MCP.md).
  68. ## Development
  69. ```bash
  70. pnpm lint # typecheck
  71. pnpm test # end-to-end API tests (needs the app, MongoDB and compiler running)
  72. pnpm build # production build
  73. pnpm preview # build + run in the local Workers runtime
  74. ```
  75. ## Security notes
  76. - LaTeX is code. The compiler runs `pdflatex` with `-no-shell-escape`, paranoid file access, a timeout, and
  77. should run in an unprivileged container (the provided compose file drops capabilities and uses a read-only root).
  78. Don't expose it publicly without `AUTH_TOKEN`.
  79. - Passwords use PBKDF2-SHA256; sessions are signed `httpOnly` cookies that are revoked on logout; API tokens are stored as SHA-256 hashes.
  80. - Rate limits (MongoDB-backed): login 8 failures / 10 min per IP+email and 20 / 15 min per account, signup 10 / hour per IP, compile 30 / min per user with one in-flight compile per user. Behind a reverse proxy set `TRUST_PROXY=true`.
  81. - The AI base URL cannot target private/loopback hosts in production.
  82. - Report vulnerabilities as described in [SECURITY.md](SECURITY.md).
  83. ## Contributing
  84. PRs welcome — see [CONTRIBUTING.md](CONTRIBUTING.md). Licensed under the [MIT License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.