chore: update project dependencies and add README and TODO files for better documentation and feature tracking

README.md

@@ -0,0 +1,152 @@
+---
+title: LinkedIn Career Advisor
+emoji: 🚀
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 3.50.2
+app_file: app/main.py
+pinned: false
+---
+
+# LinkedIn Career Advisor 🚀
+
+![Python](https://img.shields.io/badge/Python-3.9%2B-blue)
+![Gradio](https://img.shields.io/badge/Gradio-UI-orange)
+![OpenAI](https://img.shields.io/badge/OpenAI-API-green)
+![License](https://img.shields.io/badge/License-MIT-lightgrey)
+
+A professional career pathway analysis tool that leverages AI to provide tailored career path recommendations based on your professional background, education, and goals. No telemetry.
+
+![LinkedIn Career Advisor Demo](https://img.shields.io/badge/Demo-Hugging%20Face%20Spaces-yellow)
+
+## ✨ Features
+
+- **Comprehensive Career Analysis**: Get detailed insights on potential career paths tailored to your unique professional background
+- **Multi-dimensional Evaluation**: Each path is scored on financial potential, human impact, and opportunity creation
+- **Customizable Preferences**: Adjust weights for different factors based on your personal priorities
+- **Time Horizon Options**: Choose between short-term (3 years), mid-term (10 years), or long-term (10+ years) career planning
+- **Easy Sharing**: Export your analysis to LinkedIn or copy to clipboard with a single click
+- **Intuitive Interface**: User-friendly Gradio UI for seamless interaction
+
+## 🔧 Installation
+
+### Prerequisites
+
+- Python 3.12 or higher
+- OpenAI API key
+
+### Setup
+
+1. Clone the repository:
+```bash
+git clone https://github.com/danivpv/linkedinadvice.git
+cd linkedinadvice
+```
+
+2. Install dependencies using uv (recommended):
+```bash
+uv sync --all-extras
+```
+
+3. Create a `.env` file in the root directory with your OpenAI API key:
+```
+OPENAI_API_KEY=your-api-key-here
+```
+
+## 🚀 Running Locally
+
+Start the application with:
+
+```bash
+uv run poe start # alternatively, uv run gradio app/main.py
+```
+
+The Gradio interface will be available at `http://localhost:7860` in your browser.
+
+## 📦 Project Structure
+
+```
+linkedin-career-advisor/
+├── app/
+│   ├── main.py          # Application entry point and Gradio UI
+│   ├── constants.py     # Application constants and example data
+│   └── utils.py         # Utility functions for clipboard and sharing
+│
+├── linkedinadvice/
+│   ├── __init__.py
+│   ├── career_analysis.py  # Career analysis using LangChain and LLM
+│   └── monitoring.py       # API usage monitoring and logging
+│
+├── requirements.txt     # Project dependencies
+├── .env                 # Environment variables (not tracked by git)
+└── README.md            # Project documentation
+```
+
+## 🌐 Deploying to Hugging Face Spaces
+
+1. Create a new Space on [Hugging Face Spaces](https://huggingface.co/spaces)
+2. Choose Gradio as the SDK
+3. Push this repository to the created Space
+4. Add your `OPENAI_API_KEY` as a secret in the Space settings
+
+## 💻 Development
+
+### Dependencies
+
+- `gradio`: For the web interface
+- `langchain`: For LLM integration and career analysis pipeline
+- `openai`: For accessing GPT models
+- `python-dotenv`: For environment variable management
+
+### Adding New Features
+
+To extend the application:
+1. Modify the analysis logic in `linkedinadvice/career_analysis.py`
+2. Update UI components in `app/main.py`
+3. Add new constants in `app/constants.py` if needed
+
+## 📊 Usage Example
+
+1. **Input your professional experience**:
+   - Add current and previous roles
+   - Specify years of experience
+   - List notable achievements
+
+2. **Add educational background**:
+   - Enter degrees, institutions, and dates
+   - Highlight academic achievements
+
+3. **Define your goals and preferences**:
+   - Set career goals
+   - Add additional insights
+   - Adjust time horizon and factor weights
+
+4. **Analyze and review results**:
+   - Get personalized career path recommendations
+   - See detailed scoring across dimensions
+   - Export or share your results
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## 🙏 Acknowledgements
+
+- [OpenAI](https://openai.com/) for providing the underlying language models
+- [Gradio](https://gradio.app/) for the easy-to-use UI framework
+framework
+
+---
+
+Built with ❤️ for career professionals worldwide

TODO.md

@@ -0,0 +1,11 @@
+# LinkedIn Career Advice - TODO
+
+## Features
+- [ ] Data extraction from PDF
+- [ ] Sharing button to LinkedIn
+- [ ] Optimizing prompts to multiple prompts
+
+## Dev
+- [ ] Improve monitoring and logging
+- [ ] Add tests
+- [ ] Add CI/CD

app/main.py

@@ -3,7 +3,7 @@ import os
 import gradio as gr
 from dotenv import load_dotenv
 
-from app.constants import ROLE_PLACEHOLDER
+from app.constants import ROLE_PLACEHOLDER, SAMPLE_RESULT
 from app.utils import copy_to_clipboard, export_state
 from linkedinadvice.career_analysis import CareerAnalyzer
 from linkedinadvice.monitoring import monitor_api
@@ -346,10 +346,10 @@ with gr.Blocks(theme="soft") as demo:
         with gr.Column(scale=2):
             output_box = gr.Markdown(
                 output.value,
-                label="Career Analysis Report",
                 container=True,
                 height=614,
-                show_copy_button=False,
+                show_copy_button=True,
+                key="output_box",
             )
 
             with gr.Row():
@@ -403,13 +403,12 @@ with gr.Blocks(theme="soft") as demo:
         fn=lambda: None, inputs=[], outputs=[], js="() => location.reload()"
     )
 
-    """ 
     example_btn.click(
         fn=lambda _: SAMPLE_RESULT,
         inputs=[output_box],
         outputs=[output_box],
     )
-     """
+
 
 # Launch the app
 if __name__ == "__main__":

pyproject.toml

@@ -10,8 +10,6 @@ readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "gradio>=5.22.0",
-    "langchain>=0.3.21",
-    "langchain-community>=0.3.20",
     "openai>=1.68.0",
     "pyperclip>=1.9.0",
     "python-dotenv>=1.0.1",

requirements.txt

@@ -0,0 +1,169 @@
+# This file was autogenerated by uv via the following command:
+#    uv pip compile pyproject.toml -o requirements.txt
+aiofiles==23.2.1
+    # via gradio
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.9.0
+    # via
+    #   gradio
+    #   httpx
+    #   openai
+    #   starlette
+certifi==2025.1.31
+    # via
+    #   httpcore
+    #   httpx
+    #   requests
+charset-normalizer==3.4.1
+    # via requests
+click==8.1.8
+    # via
+    #   typer
+    #   uvicorn
+colorama==0.4.6
+    # via
+    #   click
+    #   tqdm
+distro==1.9.0
+    # via openai
+fastapi==0.115.11
+    # via gradio
+ffmpy==0.5.0
+    # via gradio
+filelock==3.18.0
+    # via huggingface-hub
+fsspec==2025.3.0
+    # via
+    #   gradio-client
+    #   huggingface-hub
+gradio==5.22.0
+    # via linkedinadvice (pyproject.toml)
+gradio-client==1.8.0
+    # via gradio
+groovy==0.1.2
+    # via gradio
+h11==0.14.0
+    # via
+    #   httpcore
+    #   uvicorn
+httpcore==1.0.7
+    # via httpx
+httpx==0.28.1
+    # via
+    #   gradio
+    #   gradio-client
+    #   openai
+    #   safehttpx
+huggingface-hub==0.29.3
+    # via
+    #   gradio
+    #   gradio-client
+idna==3.10
+    # via
+    #   anyio
+    #   httpx
+    #   requests
+jinja2==3.1.6
+    # via gradio
+jiter==0.9.0
+    # via openai
+markdown-it-py==3.0.0
+    # via rich
+markupsafe==3.0.2
+    # via
+    #   gradio
+    #   jinja2
+mdurl==0.1.2
+    # via markdown-it-py
+numpy==2.2.4
+    # via
+    #   gradio
+    #   pandas
+openai==1.68.2
+    # via linkedinadvice (pyproject.toml)
+orjson==3.10.15
+    # via gradio
+packaging==24.2
+    # via
+    #   gradio
+    #   gradio-client
+    #   huggingface-hub
+pandas==2.2.3
+    # via gradio
+pillow==11.1.0
+    # via gradio
+pydantic==2.10.6
+    # via
+    #   fastapi
+    #   gradio
+    #   openai
+pydantic-core==2.27.2
+    # via pydantic
+pydub==0.25.1
+    # via gradio
+pygments==2.19.1
+    # via rich
+pyperclip==1.9.0
+    # via linkedinadvice (pyproject.toml)
+python-dateutil==2.9.0.post0
+    # via pandas
+python-dotenv==1.0.1
+    # via linkedinadvice (pyproject.toml)
+python-multipart==0.0.20
+    # via gradio
+pytz==2025.1
+    # via pandas
+pyyaml==6.0.2
+    # via
+    #   gradio
+    #   huggingface-hub
+requests==2.32.3
+    # via huggingface-hub
+rich==13.9.4
+    # via typer
+ruff==0.11.2
+    # via gradio
+safehttpx==0.1.6
+    # via gradio
+semantic-version==2.10.0
+    # via gradio
+shellingham==1.5.4
+    # via typer
+six==1.17.0
+    # via python-dateutil
+sniffio==1.3.1
+    # via
+    #   anyio
+    #   openai
+starlette==0.46.1
+    # via
+    #   fastapi
+    #   gradio
+tomlkit==0.13.2
+    # via gradio
+tqdm==4.67.1
+    # via
+    #   huggingface-hub
+    #   openai
+typer==0.15.2
+    # via gradio
+typing-extensions==4.12.2
+    # via
+    #   anyio
+    #   fastapi
+    #   gradio
+    #   gradio-client
+    #   huggingface-hub
+    #   openai
+    #   pydantic
+    #   pydantic-core
+    #   typer
+tzdata==2025.1
+    # via pandas
+urllib3==2.3.0
+    # via requests
+uvicorn==0.34.0
+    # via gradio
+websockets==15.0.1
+    # via gradio-client