Setup

Prerequisites

You need two tools to develop RenderCV:

uv: Package and project manager. It also handles Python installations, so you don't need to install Python separately.
just: Command runner. Development commands are defined in the justfile, and you need just to run them.

Install them by following their official installation guides:

Clone the repository:
bash
```
git clone --recursive https://github.com/rendercv/rendercv.git
```
and change to the repository directory:
bash
```
cd rendercv
```
[!NOTE] The --recursive flag clones the rendercv-skill submodule. If you forgot it, run git submodule update --init inside the repo.
Set up the development environment (creates a virtual environment in ./.venv with all dependencies):
bash
```
just sync
```
Run just test to verify all tests pass and everything is set up correctly.
Finally, activate the virtual environment in your integrated development environment (IDE). In Visual Studio Code:
- Press Ctrl+Shift+P.
- Type Python: Select Interpreter.
- Select the one in ./.venv.

That's it! You're now ready to start developing RenderCV.