Your Personal AI Finance Mentor for a Confident Financial Start. Many young people (students, recent graduates, freelancers) face financial anxiety and don't know how to manage their first earnings.

Prosperita is a friendly AI assistant designed to make financial literacy simple, accessible, and stress-free. Understanding the basics of personal finance is the key to a confident future.

Inspired by the Hack the System hackathon.

• 🤖 "Explain to Me" Chat: Get simple, clear answers to complex financial questions in a friendly text chat.
• 🎥 AI Video Chat: Have a face-to-face conversation with an AI avatar for a more personal and engaging experience.
• 💡 Opportunity Finder: Based on your profile, the assistant helps you find information on scholarships and grants.
• 📊 Personalized Budget Plan: Instantly create a basic budget using the popular 50/30/20 rule.

• Frontend: React, Vite, TailwindCSS
• Backend: Python, FastAPI
• AI Core: Google Gemini
• Video Avatar: Tavus API
• Deploy: Docker, Render, Netlify

Here is the system architecture of Prosperità AI:

To get a local copy up and running, follow these simple steps.

1. Clone the repository:

git clone https://github.com/vero-code/prosperita.git
cd prosperita

2. Setup and run the Backend:

# Navigate to the backend directory
cd backend

# Create and activate a virtual environment
python -m venv venv

# Windows
.\venv\Scripts\activate
# macOS / Linux
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Create a .env file from the .env.example template and add your API keys

# Run the server
uvicorn main:app --reload

The backend will be available at http://127.0.0.1:8000.

3. Setup and run the Frontend (in a new terminal window):

# Navigate to the frontend directory
cd frontend

# Install dependencies
npm install

# Create a .env file and add your backend URL

# Run the app
npm run dev

The frontend will be available at http://127.0.0.1:5173 (or another port specified by Vite).

This section shows exactly how to demo in 3–5 minutes: what to click, what to type, and what to expect. The steps are available for both on-premises and web-hosted deployments.

UI path: Home → Try Text Chat → fill mini-profile form.

Sample profile (for testing):

• Name: Prosperitas user
• Status: Student

Try these prompts (copy-paste):

• “Explain inflation like I’m 17 in 5 sentences.”

• “What’s the difference between gross and net income?”

• “I work part-time and make $900/month — how should I think about taxes?”

• “What’s APR vs. APY with a simple example?”

Expected: answers with friendly tone with a personal touch.

UI path: Home → Try Text Chat → fill mini-profile form (like previous).

Expected: a list of opportunities based on profile.

Try these prompts (copy-paste):

• “Find me grants for women in STEM pursuing a master’s degree.”

• “I just graduated high school and want to learn coding. Any scholarships for bootcamps?”

• “Grants available for international students coming to study in the US”

• “I come from a household earning under $40,000/year. What financial aid could help me?”

UI path: Home → Instantly plan your budget
Test input:

• Monthly income: $1,800

Expected: automatic 50/30/20 split, colored bars, and simple tips.

• 50% Needs ≈ $900

• 30% Wants ≈ $540

• 20% Savings ≈ $360

UI path: Home → Try Video Chat

Test flow:

1. Click to start session button.

2. Say a simple question, e.g., “How do student loans work?”

3. Avatar responds (short, friendly explanation).

Distributed under the MIT License. See LICENSE for more information.