Upwork Proposal Agent 🤖

A hands-on demo built as part of the Google Cloud NEXT '26 Writing Challenge.

This agent takes a job description and writes a personalized, human-sounding proposal using Google's Agent Development Kit (ADK).

---

What It Does

Paste any job description and the agent will:

1. Identify the top skills the client needs
2. Read the tone of the post
3. Write a tailored 150-word proposal with a specific opener, relevant experience, and a soft call to action

---

Tech Stack

• Python 3.10+
• Google ADK
• Gemini 2.5 Flash
• python-dotenv

---

Getting Started

1. Clone the repo

git clone https://github.com/YOUR_USERNAME/upwork-agent.git
cd upwork-agent

2. Create and activate virtual environment

python -m venv venv
venv\Scripts\activate        # Windows
# source venv/bin/activate   # Mac/Linux

3. Install dependencies

pip install google-adk

4. Add your API key

Create a .env file in the root:

GOOGLE_GENAI_USE_VERTEXAI=FALSE
GOOGLE_API_KEY=your_gemini_api_key_here

Get a free key at Google AI Studio. No credit card needed.

5. Run the agent

adk web

Open http://127.0.0.1:8000, select upwork_agent and start chatting.

---

Built By

Faith Njeri - Full-Stack MERN + AI/ML Developer
DEV.to Article | Upwork