🌱 Fertilizer Platform

A full-stack web application aimed at connecting sustainability-focused community projects with relevant professionals and stakeholders.

🚀 Overview

The project has two main parts:

• Backend (FastAPI + AI-powered logic): Helps generate project summaries, find relevant contacts, rate their relevance, and draft outreach emails.
• Frontend (React + Material UI): A user-friendly web interface where project organizers can submit ideas, connect with experts, and manage their profile.

🎯 Key Features

Backend

• 🌍 Location-based people finder using PeopleDataLabs API.
• ✍️ AI-generated bios & email drafts with OpenAI GPT-4o integration.
• 🧠 Relevance scoring to prioritize contacts most aligned with your project.
• ✅ Project summary checker to ensure project submissions have enough context.

Frontend

• 🖥️ Networking portal with sustainability professionals.
• 📚 Resource library with articles, courses, and videos on environmental topics. (coming soon)
• 💰 Finding grant resorces and maching users with grants for their projects. (coming soon)
• 📨 Message drafting tool for professional outreach via LinkedIn.
• 🧩 Profile management with interest & skill tags.
• 🔔 Smart notifications (coming soon).

---

🧩 Tech Stack

Backend

• FastAPI
• Uvicorn
• OpenAI API (GPT-4o)
• PeopleDataLabs API
• Python 3.11+

Frontend

• React + TypeScript
• Vite
• Material UI
• Framer Motion (for animations)
• React Router

---

🗂️ Project Structure

hackuncp/
├── backend/
│   ├── main.py               # FastAPI entrypoint
│   ├── external_logic/       # API routes & helpers
│   ├── internal_logic/       # AI integrations & data models
│   ├── unittest/             # Backend tests
│   └── requirements.txt      # Python dependencies
├── frontend/plantparty/
│   ├── src/components/       # UI components (e.g., navbar, LinkedIn auth)
│   ├── src/pages/            # Main pages (Home, Network, Resources, etc.)
│   ├── src/services/         # API service for backend communication
│   └── vite.config.ts        # Vite configuration
└── README.md

---

⚙️ Getting Started

Backend

1. Navigate to the backend directory:

   cd backend

2. Install dependencies:

   pip install -r requirements.txt

3. Add your .env file with OPENAI_API_KEY and PDL_API_KEY.
4. Run the server:

   uvicorn backend.main:app --host 0.0.0.0 --port 8001 --reload

Frontend

1. Navigate to the frontend directory:

   cd frontend/plantparty

2. Install frontend dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Visit http://localhost:5173

---

🧪 Testing

For backend unit tests:

cd backend
pytest

---

✨ Credits

• OpenAI for AI text generation.
• PeopleDataLabs for people search API.
• Material-UI & Framer Motion for frontend magic.