https://github.com/tameronline/fastapi-streamlit-dynamic
https://github.com/tameronline/fastapi-streamlit-dynamic
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tameronline/fastapi-streamlit-dynamic
- Owner: TamerOnLine
- License: mit
- Created: 2025-10-01T12:42:34.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-02T00:07:00.000Z (9 months ago)
- Last Synced: 2025-10-02T00:23:11.049Z (9 months ago)
- Language: Python
- Size: 34.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
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).