https://github.com/ant1-dev/wealthagent
Learn and adapt with WealthAgent an agent powered financial learning platform!
https://github.com/ant1-dev/wealthagent
agents angular flask gemini google-adk google-cloud
Last synced: 6 months ago
JSON representation
Learn and adapt with WealthAgent an agent powered financial learning platform!
- Host: GitHub
- URL: https://github.com/ant1-dev/wealthagent
- Owner: Ant1-dev
- License: mit
- Created: 2025-09-26T22:32:24.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-09-30T00:52:33.000Z (6 months ago)
- Last Synced: 2025-09-30T07:26:48.756Z (6 months ago)
- Topics: agents, angular, flask, gemini, google-adk, google-cloud
- Language: Python
- Homepage:
- Size: 3.31 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Understanding Agents
AI-powered financial literacy platform built with multi-agent architecture for Shell Hacks 2025.
## What It Does
Personalized financial education through four AI agents that assess knowledge, create learning paths, track progress, and deliver content. Users complete an assessment and receive a customized curriculum covering investment basics, risk management, portfolio building, retirement planning, and budgeting.
## Architecture
```
Frontend (Angular) → Assessment Agent → Planning Agent → Progress Agent → Content Agent
↓
SQLite Database
```
**Agent Ports:**
- Assessment: 8000
- Planning: 8001
- Progress: 8002
- Content: 8003
## Tech Stack
**Frontend:** Angular 19, TypeScript, Auth0
**Backend:** Python 3.13, Google ADK, Gemini 2.0, Flask, SQLite
## Setup
### Backend
```bash
cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Add GOOGLE_API_KEY to .env
# Add GOOGLE_GENAI_USE_VERTEXAI=FALSE
# Set up CORS
python3 cors_wrapper.py
# Start agents (separate terminals)
./run.sh
# To terminate agents
./stop.sh
```
### Frontend
```bash
cd frontend
npm install
# Configure Auth0 in auth.config.ts
ng serve
```
## Usage
1. Sign in with Auth0
2. Complete financial literacy assessment
3. Receive personalized learning path
4. Progress through 6 modules with interactive content
5. Track completion and earn certificates
## Project Structure
```
├── frontend/src/app/
│ ├── agent-dashboard/
│ ├── learning-page/
│ ├── assessment/
│ └── agent.service.ts
└── backend/
├── assessment_agent/
├── planning_agent/
├── progress_agent/
├── content_delivery_agent/
└── shared/db_service.py
```
## Key Features
- Conversational assessment
- Risk tolerance profiling
- Adaptive learning paths
- Real-time progress tracking
- Interactive quizzes
- Step-by-step lessons
## Built With
ShellHacks 2025 - 36 hour hackathon
## License
MIT