README.md

---
title: Application Assistant
emoji: 🦛
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
fullWidth: true
header: default
short_description: AI-powered assistant to help you land your dream job.
tags:
- agent-demo-track
pinned: true
---

# 🏆 Application Assistant

### Submission for the: 🤖 Gradio Agents & MCP Hackathon 2025 🚀  
- **Track:** 3 – *Agentic Demo (agent-demo-track)*  
- **Author:** Fabian Hildebrandt

---

## 📌 Overview

**Application Assistant** 🦛🤗 is an intelligent, multi-agent application designed to support users throughout their job application journey.

![Application Assistant](application_assistant.png)

This project demonstrates the power of **multi-agent collaboration** powered by **Gradio**’s UI framework and the **LangGraph**'s agent framework. 

Whether you're writing a compelling cover letter, preparing for an interview, or polishing your CV, **Application Assistant** is here to help.


[Video Tutorial](https://github.com/FabianHildebrandt/Application-Assistant/tree/main) (available on the GitHub Repo)

https://github.com/user-attachments/assets/4f17e8f7-8993-40bb-9de1-ce72c0cab473



## 🤖 What Can It Do?

- 📝 **Cover Letter Generator:** Draft, refine, and customize cover letters tailored to specific job roles.
- 🎤 **Interview Prep:** Simulate mock interview question sets and feedback.
- 👥 **Multi-Agent Collaboration:** Breaks down tasks into sub-tasks handled by specialized agents (e.g., Writer agent, critic agent, interview agent).


## 🧠 Multi-Agent System

The Application Assistant uses a modular agent system:

![Architecture](mas_architecture.png)


These agents communicate and collaborate via a central orchestrator.


## 🚀 Getting Started

### 🔧 Prerequisites
- Python installed
- `pip` installed
- Google AI API key -> [Get a free API key](https://ai.google.dev/gemini-api/docs/api-key)

### 📥 Installation

```bash
git clone 
cd application-assistant
pip install -r requirements.txt
python app.py
```

---
## 🧭 Using the Tool

Once you've launched the app (by running `python app.py`), open your default browser and navigate to the Gradio interface at `http://localhost:7860`.

![Interface](interface.png)

From there, you can:
1. **Input Your Details** such as job descriptions, existing CV and previous motivation letters and your general motivation.
2. **Interact with the Agents** using the Q&A Chatbot.
3. **Copy** your polished text or copy it directly for use in job applications.

The interface is designed to be intuitive, responsive, and ready to support you at any stage of your job application journey.

The app is also compatible with a Jupyter environment.