https://github.com/techboy-coder/bernhack25
https://github.com/techboy-coder/bernhack25
Last synced: 12 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/techboy-coder/bernhack25
- Owner: techboy-coder
- Created: 2025-08-22T19:18:28.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-23T23:09:11.000Z (10 months ago)
- Last Synced: 2025-08-23T23:43:59.469Z (10 months ago)
- Language: Svelte
- Size: 6.69 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SpendCast 💰🎙️
**Bring your finances to life with AI-powered conversations**
Built during [BärnHäckt 2025](https://www.bernhackt.ch) - A hackathon project that transforms personal finance data into engaging, conversational experiences.
## 🏆 Challenge: PostFinance SpendCast
SpendCast is an intelligent, multimodal financial assistant that uses generative AI, knowledge graphs, and AI agents to provide personalized, natural language responses about your spending habits. Think Spotify Wrapped, but for your finances.
## ✨ Features
- 🗣️ **Natural Language Queries**: Ask questions like "How much did I spend on unhealthy food last month?"
- 🎵 **Text-to-Speech**: Get responses as spoken audio using Chrome TTS
- 🎤 **Speech-to-Text**: Voice input support via Chrome STT
- 📊 **Animated Visualizations**: Beautiful slide presentations using Animotion
- 🧠 **AI Agent Orchestra**: Intelligent agents coordinate data access and analysis
- 🕸️ **Knowledge Graph Integration**: Connects personal data with external sources (Open Food Facts, Wikidata)
- 🎯 **MCP Protocol**: Model Context Protocol for seamless data source integration
- 📱 **Responsive UI**: Modern interface built with ShadCN components and Tailwind CSS
## 🛠️ Tech Stack
### Frontend
- **SvelteKit** - Full-stack framework
- **ShadCN/UI** - Component library
- **Tailwind CSS** - Utility-first styling
- **Animotion** - Animated presentation slides
- **Chrome Web APIs** - TTS/STT integration
### Backend
- **Hono** - Lightweight web framework
- **LLM Query Layer** - Custom data querying system
- **AI Agents** - Orchestrated intelligence system
- **MCP (Model Context Protocol)** - Data source dumping and querying
### Architecture
- **Microservices** - Distributed service architecture
- **Knowledge Graphs** - Structured data relationships
### Planned/WIP Features
- **OCR System** - Document text extraction (unfinished)
- **External APIs** - Open Food Facts, Wikidata integration
## 🏗️ Architecture Overview
```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ SvelteKit │ │ Hono API │ │ LLM Query │
│ Frontend │◄──►│ Gateway │◄──►│ Layer │
│ │ │ │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Chrome APIs │ │ AI Agents │ │ Knowledge │
│ (TTS/STT) │ │ Orchestrator │ │ Graph │
└─────────────────┘ └─────────────────┘ └─────────────────┘
```
## 💬 Usage Examples
[Youtube Demo](https://www.youtube.com/watch?v=8hJrAomTCUc)
### Voice Interactions
- "How much did I spend on groceries this month?"
- "What's my biggest spending category?"
- "Show me my unhealthy food expenses as a podcast"
### Response Formats
- 🎵 **Audio**: Spoken responses and podcast-style summaries
- 📊 **Visual**: Animated charts and infographics
- 📱 **Interactive**: Chat, speak and interact with the AI bot
_Built with ❤️ during BärnHäckt 2025_