https://github.com/aqerd/cvbuilder

Build your CV fast and easy way. A Python app powered with Flask framework
https://github.com/aqerd/cvbuilder

csrf css cv email flask html js python resume site web website

Last synced: 8 months ago
JSON representation

Build your CV fast and easy way. A Python app powered with Flask framework

• Host: GitHub
• URL: https://github.com/aqerd/cvbuilder
• Owner: aqerd
• License: mit
• Created: 2024-11-09T18:43:15.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-07T18:15:21.000Z (12 months ago)
• Last Synced: 2025-07-07T20:39:05.058Z (12 months ago)
• Topics: csrf, css, cv, email, flask, html, js, python, resume, site, web, website
• Language: Python
• Homepage:
• Size: 4.24 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Logo](images/logo.png)

[![Follow @aqerd on GitHub](https://img.shields.io/github/followers/aqerd?label=Ruslan%20Suleymanov&style=social-&labelColor=black&color=black)](https://github.com/aqerd)

[![Follow @RasulGasanbekov on GitHub](https://img.shields.io/github/followers/RasulGasanbekov?label=Rasul%20Gasanbekov&style=social-&labelColor=black&color=black)](https://github.com/RasulGasanbekov)

[![Follow @tazik23 on GitHub](https://img.shields.io/github/followers/tazik23?label=Vladimir%20Golubev&style=social-&labelColor=black&color=black)](https://github.com/tazik23)

[![Open issues for CVbuilder](https://img.shields.io/github/issues/aqerd/CVbuilder?label=Issues&labelColor=black&color=black)](https://github.com/aqerd/CVbuilder/issues)

[![Watch CVbuilder on GitHub](https://img.shields.io/github/watchers/aqerd/CVbuilder?label=Watch&style=social-&labelColor=black&color=black)](https://github.com/aqerd/CVbuilder/subscription)

[![Star CVbuilder on GitHub](https://img.shields.io/github/stars/aqerd/CVbuilder?label=Star&style=social-&labelColor=black&color=black)](https://github.com/aqerd/CVbuilder)

### Build your CV fast and easy way

![Profile](images/profile.png)

## 🔗 How to run

Clone our repository:

```shell

git clone https://github.com/aqerd/CVbuilder.git

```

Set the environmental variables in `.env`. For reference see [`.env.example`](https://github.com/aqerd/CVbuilder/blob/main/.env.example) file.

> [!NOTE]

> To get your Google API key, visit the [documentation](https://console.developers.google.com/).

> You can collect your email password by creating a new email on any SMTP Server and retrieving it from the settings.

Make sure you have `Python 3.10` (at least), `make` (install it if you have Windows) and `Docker Engine` installed on your machine.

To build and up docker container run this:

```bash

make

```

Now go to [`localhost:8181`](http://localhost:8181) in your browser.

> [!IMPORTANT]

> Note that you might encounter a connection error if you're running this in Russia.

## 🔨 Powered by

- Python

- uv

- Ruff

- Flask

- Docker

- HTML, CSS and JavaScript

- Google's Gemini 2.5 Flash with GenAI

## 🎨 Site design

Designed by Ruslan Suleymanov in Figma. See this project on [`Behance`](https://www.behance.net/gallery/215413437/CVbuilder) or in [`Figma Community`](https://www.figma.com/community/file/1465009107029457211/cv-builder).

## 🖼️ Contribute with new theme

Want to contribute our project with new theme design? See this [`documentation`](/docs/THEMES.md)

![Themes](images/themes.png)

## 🚀 Deployment

Site is deployed on [`cvbuilder.art`](https://cvbuilder.art/) on `Yandex Cloud` with `Apache HTTP Server`. AI features are disabled since it's deployed in Russia

## 🧑‍💻 Credits

Project made by `Ruslan Suleymanov`, `Rasul Gasanbekov` and `Vladimir Golubev` for Python course at Ural Federal University