Skip to content

Repository files navigation

Personal AI CV Assistant

An AI-powered personal assistant that answers questions about you — built with React (frontend), FastAPI (backend), and Google Gemini (AI).

Recruiters and visitors can ask anything about your experience, skills, and projects in a natural chat interface.

preview


Features

  • Chat interface powered by Google Gemini AI
  • English / Turkish language toggle
  • Dark / Light theme toggle
  • CV download links (Turkish & English)
  • Social media & contact section in a collapsible sidebar
  • Optional Telegram logging for each query

Tech Stack

LayerTechnology
FrontendReact, Vanilla CSS
BackendFastAPI (Python)
AIGoogle Gemini 2.0 Flash via OpenAI-compatible API
IconsLucide React

Getting Started

Prerequisites


1. Clone the repository

git clone https://github.com/YOUR-USERNAME/personal-cv-assistant.git
cd personal-cv-assistant

2. Configure environment variables

Copy the example env file and fill in your keys:

cp .env .env.local

Edit .env:

GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE

3. Add your personal data

Edit bilgi.txt with your own information:

  • Name, title, education
  • Technical skills
  • Work experience and projects
  • Contact info

4. Install backend dependencies

pip install -r requirements.txt

5. Start the backend

uvicorn main:app --reload

The API will be available at http://127.0.0.1:8000.

6. Install & start the frontend

cd frontend
npm install
npm start

Open http://localhost:3000 in your browser.


Customization

WhatWhere
Your info & biobilgi.txt
AI personality & namemain.pysystem_prompt
Bot name & labelsfrontend/src/translations.js
Profile photofrontend/public/profile.png
CV PDFsfrontend/public/YOUR_CV_TR.pdf, YOUR_CV_EN.pdf
Social & contact linksfrontend/src/components/Sidebar.js

📡 Optional: Telegram Logging

You can receive a Telegram notification for every question asked. To enable:

  1. Create a bot via @BotFather and get your token.

  2. Get your Chat ID via @userinfobot.

  3. Fill in .env:

  4. preview

TELEGRAM_TOKEN=YOUR_TOKEN
TELEGRAM_CHAT_ID=YOUR_CHAT_ID

Project Structure

personal-cv-assistant/
├── bilgi.txt # Your personal data (AI's knowledge base)
├── main.py # FastAPI backend
├── requirements.txt # Python dependencies
├── .env # API keys (never commit this)
└── frontend/
├── public/
│ ├── profile.png # Your profile photo
│ └── *.pdf # Your CV files
└── src/
├── App.js
├── translations.js
└── components/
├── Sidebar.js
└── ChatArea.js

📄 License

MIT License — feel free to fork and adapt for your own use.

About

An AI-powered personal assistant that answers questions about you. Built with React, FastAPI & Google Gemini.

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Contributors

Languages