.svg){kind=link}
Made with 💚 @ PennApps XXVI
- Apoorv Thite
- Aarya Soni
- Kartavya Suhagiya
- Nikhil Saini
- Modak Yadavalli
A revolutionary fintech application that rewards sustainable spending through AI-powered eco-scoring, real bank integration, and personalized environmental insights.
GreenBucks transforms how people think about their environmental impact by connecting real banking data to eco-friendly rewards and actionable insights. Using advanced AI and machine learning, we analyze spending patterns to provide personalized recommendations for more sustainable financial decisions.
- 🏦 Real Bank Integration: Connect via Plaid to analyze actual spending data
- 🌍 CO2-Based Eco-Scoring: Realistic environmental impact calculations for every transaction
- 💰 Smart Cashback System: Earn rewards based on eco-friendliness (up to 5% for Eco++ purchases)
- 🤖 AI Assistant (Koshi): Personalized eco-tips powered by Google Gemini AI
- 📱 Receipt OCR: Upload receipts for item-level environmental analysis
- 📊 Comprehensive Analytics: Real-time dashboards and spending insights
- 🏅 Gamification: Leaderboards and eco-challenges for behavior change
Demo Credentials:
- Email:
[email protected] - Password:
password123
- React 18 with Vite for fast development
- Tailwind CSS for modern, responsive design
- React Router for seamless navigation
- Zustand for state management
- Lucide React for beautiful icons
- FastAPI (Python) for high-performance API
- PostgreSQL for robust data storage
- SQLAlchemy for database ORM
- Plaid API for secure bank connectivity
- Google Vision API for OCR processing
- Tesseract OCR as failsafe for image recognition
- Climatiq API for accurate carbon impact calculations
- Google Gemini AI for intelligent conversational responses
- Cerebras API for accurate receipt item parsing
- Custom CO2 Calculation Engine powered by Climatiq API
- Receipt Analysis Pipeline for item-level eco-scoring
- Alembic for database migrations
- Pydantic for data validation
- CORS enabled for secure cross-origin requests
GreenBucks/
├── greenfrontend/ # React frontend application
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ │ ├── UI/ # Base UI components (Button, Card, etc.)
│ │ │ ├── Layout/ # Layout components (Header, Footer)
│ │ │ ├── Decor/ # Visual components (Backgrounds, Hero)
│ │ │ └── Koshi/ # AI chatbot components
│ │ ├── routes/ # Page components
│ │ ├── lib/ # Utilities and API clients
│ │ └── assets/ # Static assets
├── greenbackend/ # FastAPI backend application
│ ├── backend/
│ │ ├── app/
│ │ │ ├── api/ # API route handlers
│ │ │ ├── models/ # Database models
│ │ │ ├── services/ # Business logic
│ │ │ └── db/ # Database configuration
│ └── alembic/ # Database migrations
└── README.md
graph TD
A[🚀 User visits GreenBucks] --> B[🔐 Login/Register]
B --> C[📱 Connect Bank via Plaid]
C --> D[⚡ Auto-sync 100+ Transactions]
D --> E[🤖 AI Eco-Scoring with Climatiq]
E --> F[📊 View Dashboard]
F --> G[💚 Check Eco-Wallet]
F --> H[📈 See Green Score: Average Rating]
F --> I[⭐ View Eco Points & Ranking]
G --> J[🧾 Upload Receipt for Mixed Purchases]
J --> K[👁️ Google Vision OCR Processing]
K --> L[🧠 Cerebras AI Item Parsing]
L --> M[🌍 Climatiq CO2 Analysis]
M --> N[💰 Calculate Item-level Cashback]
N --> O[✅ Attach Receipt to Transaction]
H --> P[🤖 Chat with Koshi AI Assistant]
P --> Q[💡 Get Personalized Eco-Tips]
Q --> R[🎯 Receive Behavior Nudges]
R --> S[📚 Learn Environmental Impact]
I --> T[🏆 Check Leaderboard Position]
T --> U[👥 Compare with Friends]
U --> V[🎮 Join Eco-Challenges]
V --> W[🏅 Earn Achievement Badges]
O --> X[🔄 Real-time Score Updates]
S --> X
W --> X
X --> Y[📊 Track Monthly Progress]
Y --> Z[🌱 Build Sustainable Habits]
style A fill:#10b981
style B fill:#3b82f6
style C fill:#8b5cf6
style D fill:#f59e0b
style E fill:#ef4444
style F fill:#06b6d4
style Z fill:#10b981
- 🚀 Onboarding → Login with demo credentials (
[email protected]/password123) - 🏦 Bank Connection → Secure Plaid integration syncs transaction history
- 🤖 AI Analysis → Climatiq API calculates CO2 impact, assigns eco-scores (1-10)
- 📊 Dashboard View → See Eco-Wallet ($23,379+), Green Score, and Eco Points
- 🧾 Receipt Upload → OCR + AI parsing for detailed item-level analysis
- 💬 AI Assistant → Chat with Koshi for personalized sustainability tips
- 🏆 Gamification → Compete on leaderboards, earn badges, join challenges
- 🌱 Behavior Change → Track progress and build sustainable spending habits
# Backend
cd greenbackend && pip install -r requirements.txt
uvicorn backend.app.main:app --reload --port 8787
# Frontend
cd greenfrontend && npm install && npm run devEnvironment Variables: Plaid, Google Vision/Gemini, Cerebras, Climatiq API keys required.
- Plaid Sandbox Integration: Secure connection to 4,160+ realistic transactions
- Real-time Sync: Automatic transaction updates and categorization
- Multi-bank Support: Connect multiple accounts seamlessly
- Privacy First: Bank data encrypted and processed securely
Our proprietary eco-scoring algorithm analyzes transactions using:
-
Category-Based Scoring:
- Public Transit: 9-10 (Eco++)
- Groceries/Coffee: 7-8 (Eco+)
- Restaurants: 5-6 (Neutral)
- Gas/Ride Share: 3-4 (Less-Eco)
- Airlines: 1-2 (Non-Eco)
-
Climatiq API Integration: Precise CO2 calculations using real environmental data
-
Receipt Analysis: Item-level scoring for mixed retailers
-
Dynamic Adjustments: Scores evolve with spending patterns
Why "Koshi"? In Sanskrit, "Koshi" (कोशी) means "treasury" or "treasure chest" - perfectly embodying our AI assistant who helps you discover the hidden treasures of sustainable living while building your eco-wallet. Just as a treasury holds valuable resources, Koshi holds the wisdom to transform your spending habits into environmental rewards.
Koshi's Capabilities:
- Personalized Analysis: Examines your unique spending patterns using real transaction data
- Smart Recommendations: Suggests eco-friendly alternatives based on your lifestyle
- Behavioral Coaching: Provides gentle nudges toward more sustainable choices
- Environmental Education: Explains the CO2 impact of your purchases in simple terms
- Progress Celebration: Acknowledges your eco-improvements and milestones
- Interactive Chat: Powered by Google Gemini AI for natural, helpful conversations
- Voice Integration: Supports speech-to-text and text-to-speech for accessibility
Advanced receipt processing pipeline with multiple AI layers:
- Google Vision API: Primary OCR for text extraction from receipt images
- Tesseract OCR: Failsafe backup for image recognition when Vision API fails
- Cerebras API: Accurate parsing of extracted text into individual items and prices
- Climatiq CO2 Analysis: Precise environmental impact calculations for each item
- Eco-Scoring: Assigns environmental scores based on real carbon footprint data
- Transaction Linking: Associates receipts with bank transactions
Dynamic reward system based on eco-scores:
- Base Rate: 1% on all purchases
- Eco Bonus: Up to 4% additional for sustainable spending
- Total Potential: Up to 5% cashback on Eco++ purchases
- Real Rewards: $23,379+ in total available cashback
- Total Cashback: $23,379+ available across all users
- Personal Earnings: Real-time tracking of individual cashback
- Reward Rates: Dynamic 1-5% based on eco-score performance
- Monthly Growth: Track sustainable spending improvements
- Average Rating: Environmental impact across all transactions (1-10 scale)
- Category Breakdown: Performance by spending category
- Trend Analysis: Month-over-month eco-score improvements
- CO2 Impact: Real carbon footprint data via Climatiq API
- Base Points: Direct correlation with eco-scores
- Bonus Multipliers: Extra points for Eco++ purchases
- Achievement Rewards: Special bonuses for milestones
- Leaderboard Ranking: Compare with community members
- Category Breakdown: Detailed spending by environmental impact
- Merchant Recognition: 40+ specific merchants with custom scoring
- Trend Tracking: Month-over-month improvement in eco-scores
- Goal Setting: Personalized targets for sustainable spending
Top Eco-Warriors:
Achievement Badges: Eco++ Streak, Carbon Saver, Transit Hero, Green Shopper (Future Scope)
- Bank-Level Security: Plaid's industry-standard encryption
- JWT Authentication: Secure user session management
- Data Minimization: Only necessary financial data processed
- Transparent Processing: Clear explanation of data usage
- User Control: Easy account deletion and data export
- Lazy Loading: Components loaded on demand
- Code Splitting: Optimized bundle sizes
- Caching: Smart data caching with cache busting
- Responsive Design: Mobile-first approach
- Database Indexing: Optimized query performance
- Connection Pooling: Efficient database connections
- Async Processing: Non-blocking I/O operations
- Error Handling: Comprehensive error management
- CO2 Awareness: Users understand environmental cost of purchases
- Behavior Change: Incentivized shift to sustainable options
- Education: Learning about eco-friendly alternatives
- Community: Shared commitment to environmental responsibility
- 4,160+ Transactions: Successfully processed and scored
- 100% Uptime: Robust error handling and recovery
- Sub-second Response: Fast AI-powered insights
- Scalable Architecture: Ready for production deployment
- Multi-Bank Support: Connect multiple accounts from different institutions
- International Banks: Expand beyond US to global banking systems
- Credit Card Integration: Include credit card transactions and rewards
- Investment Tracking: Monitor ESG investments and sustainable portfolios
- Group Eco-Challenges: Monthly sustainability competitions
- Shared Goals: Collective carbon reduction targets
- Progress Sharing: Real-time updates on group performance
- Reward Splitting: Share cashback earnings for group achievements
- Multiple Categories: Transit heroes, green shoppers, carbon savers
- Seasonal Competitions: Quarterly eco-challenges with prizes
- Local Rankings: Compare with users in your city/region
- Achievement Badges: Unlock special recognition for milestones
- Splitwise Integration: Seamless bill splitting with eco-score tracking
- Shared Receipts: Upload group purchases and distribute eco-points
- Fair Share Calculation: Split environmental impact among participants
- Group Cashback: Collective rewards for sustainable group spending
- Partner Discounts: Exclusive deals with eco-friendly brands
- Cashback Redemption: Convert eco-points to real shopping credits
- Sustainable Products: Curated marketplace for green alternatives
- Local Business Partnerships: Support eco-friendly local merchants
- Milestone Rewards: Physical prizes for top performers
- Certification Programs: Eco-warrior certificates and credentials
- Brand Partnerships: Exclusive access to sustainable product launches
- Carbon Offset Credits: Purchase real carbon offsets with eco-points
- Spending Forecasts: Predict future eco-score trends
- Behavior Recommendations: AI-powered suggestions for improvement
- Impact Projections: Visualize long-term environmental benefits
- Goal Optimization: Personalized targets based on lifestyle patterns
- Carbon Footprint Dashboard: Detailed CO2 emissions by category
- Water Usage Calculations: Track water impact of purchases
- Waste Generation Metrics: Monitor packaging and waste production
- Biodiversity Impact: Assess effects on ecosystems and wildlife
- Contextual Suggestions: Location and time-based eco-tips
- Habit Formation: AI-guided sustainable behavior development
- Personalized Coaching: Custom eco-improvement programs
- Predictive Nudges: Proactive suggestions before purchases
- Real-time OCR: Instant receipt processing via mobile camera
- Ingredient Analysis: Detailed sustainability scoring for food items
- Brand Recognition: Automatic identification of eco-friendly brands
- Alternative Suggestions: Recommend greener product alternatives
- Native iOS/Android Apps: Full-featured mobile experience
- Offline Functionality: Core features available without internet
- Push Notifications: Real-time eco-tips and achievement alerts
- Widget Integration: Quick eco-score checks from home screen
- Mint/YNAB Sync: Import data from existing financial tools
- Google Pay/Apple Pay: Direct integration with mobile wallets
- Amazon/Shopping APIs: Analyze online purchase sustainability
- Fitness Apps: Connect eco-actions with health and wellness goals
- Company Dashboards: Track employee eco-spending patterns
- Team Challenges: Department-wide sustainability competitions
- CSR Integration: Connect with corporate social responsibility programs
- Expense Report Integration: Eco-scoring for business expenses
- Campus Challenges: University-wide sustainability competitions
- Student Discounts: Special rates for educational institutions
- Research Partnerships: Collaborate on environmental impact studies
- Curriculum Integration: Educational content for sustainability courses
We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
POST /auth/login # User login
POST /auth/register # User registration
POST /auth/verify-token # Token verification
GET /transactions/ # List user transactions
POST /transactions/sync # Sync Plaid transactions
GET /transactions/{id} # Get specific transaction
POST /receipts/upload # Upload and process receipt
GET /receipts/{id}/items # Get receipt items
POST /receipts/attach # Attach receipt to transaction
POST /plaid/link-token # Create Plaid link token
POST /plaid/exchange # Exchange public token for access token
POST /plaid/sync # Sync transactions from Plaid
Built by passionate developers at PennApps XXVI
- PennApps XXVI for the incredible hackathon experience
- Plaid for secure banking API access
- Google Cloud for Gemini AI and Vision API services
- Cerebras for high-performance receipt parsing
- Climatiq for accurate carbon footprint calculations
- Tesseract OCR for reliable text recognition
- Open Source Community for amazing tools and libraries
Made with 💚 @ PennApps XXVI
Transforming finance for a sustainable future, one transaction at a time. 🌍✨