An open API service indexing awesome lists of open source software.

https://github.com/tameronline/fastapi-streamlit-dynamic


https://github.com/tameronline/fastapi-streamlit-dynamic

Last synced: 9 months ago
JSON representation

Awesome Lists containing this project

README

          

# ๐Ÿงพ fastapi-streamlit-resume

An interactive **Resume Builder** built with **Streamlit** (frontend) and **FastAPI** (backend).
Generates professional two-column PDF files with profile photo, icons, dynamic sections, and full Arabic (RTL) text support.

---

## โœจ Features

- โšก **FastAPI**: High-performance backend API for PDF generation.
- ๐ŸŽจ **Streamlit**: Simple, intuitive frontend interface for filling out resume data.
- ๐Ÿ–ผ๏ธ **ReportLab**: High-quality PDF rendering with flexible layout.
- ๐ŸŒ **Multilingual support**: Arabic, German, English.
- ๐Ÿ› ๏ธ Dynamic sections: Projects, Skills, Languages, Education, and extra sections.
- ๐Ÿ“ท Optional profile photo with automatic circular cropping.

---

## ๐Ÿ“ฆ Requirements

- Python 3.10+
- Install dependencies from `requirements.txt`:

```bash
pip install -r requirements.txt
```

---

## ๐Ÿš€ Run

### 1. Start Backend (FastAPI)
```bash
uvicorn api.main:app --reload
```
- Interactive API docs available at:
[http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)

### 2. Start Frontend (Streamlit)
```bash
streamlit run frontend/app.py
```
- UI available at:
[http://localhost:8501](http://localhost:8501)

---

## ๐Ÿ“ Usage

1. Open the Streamlit UI and fill in your details (name, phone, GitHub, LinkedIn, skills, projects โ€ฆ).
2. Optionally upload a profile photo.
3. Click **Generate PDF** to instantly create your resume.

---

## ๐Ÿ“‚ Project Structure

```
.
โ”œโ”€โ”€ api/ # FastAPI backend code
โ”‚ โ”œโ”€โ”€ main.py # API entry point
โ”‚ โ”œโ”€โ”€ pdf_utils/ # PDF generation utilities (icons, fonts, layout)
โ”‚ โ””โ”€โ”€ routes/ # API routes
โ”œโ”€โ”€ frontend/ # Streamlit UI code
โ”œโ”€โ”€ outputs/ # Generated PDF files
โ”œโ”€โ”€ profiles/ # Saved user profiles
โ”œโ”€โ”€ requirements.txt # Dependencies
โ”œโ”€โ”€ LICENSE # MIT License
โ””โ”€โ”€ README.md # This file
```

---

## ๐Ÿ“œ License

This project is licensed under the [MIT License](LICENSE).