Managing money shouldn't be confusing — that's where RukiAI steps in.
RukiAI is a full-stack, AI-enhanced personal finance tracker designed to help users make better financial decisions through real-time insights, budget monitoring, and goal tracking. Whether you're a student, a working professional, or a retiree, RukiAI personalizes your dashboard to give meaningful suggestions about your spending, saving, and financial health.
|
📊 Smart Expense Tracking
🎯 Goal Setting & Monitoring
|
🤖 AI-Powered Insights
📧 Smart Notifications
|
💡 "You've already used 70% of your food budget this week."
🎉 "You're on track to hit your emergency savings goal ahead of schedule."
⚠️ "Your entertainment spending is 40% higher than last month."
| Backend | Database | Frontend | AI Integration | Templating |
|---|---|---|---|---|
 |
 |
 |
! |
 |
| Express Framework | Document Storage | CSS3 + EJS Templates | API Integration | Server-Side Rendering |
This project is structured in two phases, designed for both cost-effective deployment and technical showcase:
graph LR
A[User Input] --> B[Express Server]
B --> C[MongoDB]
B --> D[AI API]
D --> E[Cohere]
E --> F[Insights Generated]
F --> G[User Dashboard]
This version is built to be lightweight, scalable, and affordable for deployment. Instead of hosting a custom model — which would require expensive compute resources — this version leverages external AI APIs (like Cohere) to process user expense data and generate personalized insights.
|
✅ Minimal hosting cost (ideal for small projects) |
// Example AI Integration
const getAIAdvice = async u => {
try {
const p = await generatePrompt(u);
const r = p && await cohere.generate(
{
model: 'command-r-plus',
prompt: p, maxTokens: 300,
temperature: 0.9
});
return r?
.generations?
.[0]?.text?
.trim() || 'Unable to generate advice.';
} catch {
return
'Unable to generate financial advice. Try again later.';
}
}; |
✅ Status: This is the version intended for public use, hosted and live.
graph LR
A[Training Data] --> B[Custom Model]
B --> C[Financial Logic]
C --> D[Budget Analysis]
D --> E[Personalized Advice]
E --> F[Local Processing]
The second part of this project includes a custom-built AI model designed to simulate financial coaching and budget guidance. This version is not deployed online but is included in the repository to demonstrate advanced technical skills.
| Purpose | Benefit |
|---|---|
| 🎯 Skill Showcase | Demonstrate capability to design, train, and integrate AI models |
| 👥 Recruiter Review | Allow collaborators to review the model logic and architecture |
| 🚀 Production Simulation | Show how a self-hosted intelligent system would work at scale |
| 🔒 Data Privacy | Complete local processing for sensitive financial data |
🚫 Important Note: This version is NOT intended for deployment, as self-hosted models can be resource-intensive without a paid server or GPU support.
📁 Location: Model training, logic, and examples are located in
/ai-model/directory.
|
Track Financial Growth
|
Career-Focused Finance
|
Fixed Income Management
|
Try Before Commit
|
🗺️ Click to view our development roadmap
- Interactive Charts & Graphs
- Spending trend visualization
- Income vs expense comparisons
- Category-wise breakdowns
- Monthly/yearly financial health reports
- Advanced Analytics
- Predictive spending models
- Seasonal expense patterns
- Financial goal probability tracking
- Voice-Based Expense Logging
- "Hey RukiAI, I spent $15 on lunch"
- Natural language processing
- Multi-language support
- AI Chatbot Integration
- Real-time financial Q&A
- Budget consultation chat
- Expense categorization assistance
- Progressive Web App (PWA)
- Offline functionality
- Push notifications
- Native app experience
- Mobile Features
- Camera receipt scanning
- Location-based expense tracking
- Quick expense shortcuts
- Google Cloud Platform Integration
- Custom model deployment
- Scalable AI infrastructure
- Enhanced data processing
- Machine Learning Pipeline
- Continuous model improvement
- A/B testing for AI suggestions
- Personalized financial coaching
🚀 Quick Start Guide
- Node.js (v18 or higher)
- MongoDB (local or cloud instance)
- Cohere API key (for AI features)
-
Clone the repository
git clone https://github.com/yourusername/rukiai.git cd rukiai -
Install dependencies
npm install
-
Environment setup
cp .env.example .env # Edit .env with your configuration -
Start the application
npm run dev
-
Access the app Open
http://localhost:3000in your browser
| Dashboard | Expense Tracking | AI Insights |
|---|---|---|
We welcome contributions! Here's how you can help:
- 🐛 Report Bugs: Open an issue with bug details
- 💡 Suggest Features: Share your ideas for new features
- 🔧 Submit PRs: Help us improve the codebase
- 📖 Improve Docs: Help us make documentation better
See our Contributing Guidelines for more details.
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ for better financial health
