Prospera is an AI-driven application designed to help women confidently negotiate salaries and achieve financial equity. Leveraging Google’s Gemini AI, Prospera provides real-time salary benchmarking, personalized negotiation coaching, and career guidance tailored to individual needs and aspirations.
- Prerequisites
- Installation and Setup
- Usage
- Testing Prospera
- Project Structure
- Built With
- Contributing
- License
To get started with Prospera, make sure you have the following installed:
- Docker: Get Docker
- Docker Compose: Verify with
docker-compose --version(Docker Compose is included with Docker Desktop) - Make: Installing Make
- Google API Key: Have a Google API Key and add it to the
.envfile (see below).
Clone the repository and navigate into the project directory:
git clone https://github.com/doniacld/prospera.git
cd prosperaProspera requires specific environment variables for API keys and configuration. Follow these steps to set up your environment:
-
Create a
.envfile in the project root:cp .env.example .env
-
Open
.envand configure the required values:API_KEY=your_google_api_key_here ANOTHER_VARIABLE=another_value
To build and run both backend and frontend containers:
make docker-upTo stop the containers:
make docker-downTo run each service locally, you can use the following commands:
-
Start the Backend:
make run-backend
-
Start the Frontend:
make run-frontend
-
Stopping Services Locally:
make kill-local
Once Prospera is running, you can access the application through your browser:
- Frontend: Visit
http://localhost:3000 - Backend API: Available at
http://localhost:8080
- Salary Benchmarking: Fill out the input form to receive real-time salary insights.
-
Negotiation Coach Chat: Engage in a real-time chat to practice negotiation scenarios.

-
Tips Chat: Interact with Prospera’s AI-driven coach for personalized advice.

- Input Form: Use the form on the frontend to input salary details, experience, location, and more. Submit the form to get a salary benchmarking response.
- Negotiation Coaching: Access the negotiation coach to receive interactive guidance. The backend processes responses in real-time using WebSocket, simulating a live conversation.
- Chat Interface: Test the WebSocket functionality by engaging in a back-and-forth conversation with the AI, ensuring seamless real-time responses.
- Docker logs: Use
docker-compose logs -fto monitor backend and frontend logs while testing. - Local logs: When running locally, logs will appear in each terminal window where the backend and frontend are running.
Here’s an overview of the main files and directories:
plaintext
Copier le code
prospera/
├── app/ # Go backend
│ ├── main.go # Backend entry point
│ ├── Dockerfile # Backend Dockerfile
│ └── ...
├── prospera-app/ # React frontend
│ ├── src/ # React source code
│ ├── Dockerfile # Frontend Dockerfile
│ └── ...
├── docker-compose.yml # Docker Compose configuration
├── Makefile # Makefile for easy setup and testing
├── .env.example # Example environment file
└── README.md # Project documentation
The full architecture looks like this

- Go: Backend API and WebSocket server
- React: Frontend UI
- Google Gemini AI: AI-driven negotiation assistance
- Docker & Docker Compose: Containerized environment for easy deployment
- Make: Simplifies running and managing local and Docker environments
Contributions are welcome! Please follow these steps if you would like to contribute to Prospera:
- Fork the repository
- Create a new feature branch (
git checkout -b feature/YourFeature) - Commit your changes (
git commit -m 'Add new feature') - Push to the branch (
git push origin feature/YourFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
For any questions or feedback, please open an issue.




