https://github.com/adhamafis/curiopay
CurioPay is an open-source budget tracking app that uses Large Language Models (LLMs) to provide personalized financial insights. Track your expenses, set budgets, and interact with AI to optimize your spending. Fully customizable, privacy-focused, and easy to deploy locally. Contributions welcome!
https://github.com/adhamafis/curiopay
budget budget-tracker cohere gorq groq-api llm next-auth nextjs ollama ollama-api prisma rag
Last synced: 6 months ago
JSON representation
CurioPay is an open-source budget tracking app that uses Large Language Models (LLMs) to provide personalized financial insights. Track your expenses, set budgets, and interact with AI to optimize your spending. Fully customizable, privacy-focused, and easy to deploy locally. Contributions welcome!
- Host: GitHub
- URL: https://github.com/adhamafis/curiopay
- Owner: AdhamAfis
- License: mit
- Created: 2024-11-05T11:11:33.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-01-06T13:44:12.000Z (6 months ago)
- Last Synced: 2025-01-24T23:49:40.667Z (6 months ago)
- Topics: budget, budget-tracker, cohere, gorq, groq-api, llm, next-auth, nextjs, ollama, ollama-api, prisma, rag
- Language: TypeScript
- Homepage: https://curiopay.vercel.app
- Size: 1.43 MB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Curiopay: Open Source Budget Tracking App with LLM Insights
[](https://opensource.org/licenses/MIT) [](https://github.com/adhamafis/curiopay) [](https://www.typescriptlang.org/) [](https://nextjs.org/) [](https://tailwindcss.com/)
Curiopay is a free, open-source app for tracking your budget and getting personalized financial insights using AI-powered Large Language Models (LLMs). It helps you track expenses, set budgets, and receive AI-driven advice—all while keeping your data secure with local deployment options.
---
## Key Features
- **Expense Tracking**: Log income and expenses with categories and dates.
- **Budget Alerts**: Real-time notifications and email alerts when budgets are exceeded.
- **AI Financial Insights**: Chat with LLMs for personalized spending advice.
- **Recurring Expenses**: Automate daily, weekly, or monthly expense tracking.
- **Data Export**: Save data in CSV or JSON formats.
- **Secure and Private**: Local deployment ensures complete control of your financial data.
### In Progress
- Responsive mobile-friendly design and themes.
- Expanded LLM provider support.
### Planned
- Mobile app development.
- Receipt scanning for automatic expense entry.
- Advanced analytics like predictive spending trends.
---
## Installation
### Prerequisites
- **Node.js** (v14+)
- **npm**
- **Docker** (for local PostgreSQL server)
### Quick Setup
1. Clone the repository:
```bash
git clone https://github.com/adhamafis/curiopay.git
cd curiopay
```
2. Run the setup script:
```bash
./setup.sh
```
The script:
- Configures environment variables (`.env` file).
- Sets up a local PostgreSQL database with Docker.
- Guides you through API keys and email setup.
---
## Usage
- Log and categorize your income and expenses.
- Set budgets and receive alerts if exceeded.
- Interact with AI for spending insights.
- Export your data for offline analysis.
---
## Contributing
Contributions are welcome! Here’s how to get started:
1. **Fork and Clone** the repository:
```bash
git clone https://github.com/adhamafis/curiopay.git
cd curiopay
```
2. **Create a new branch**:
```bash
git checkout -b feature/new-feature
```
3. **Make your changes** and commit:
```bash
git commit -am "Add new feature"
```
4. **Push and create a pull request**.
Every contribution—big or small—makes Curiopay better!
---
## License
Curiopay is licensed under the [MIT License](LICENSE).
---
## Contact
For questions or suggestions:
**Email**: [[email protected]](mailto:[email protected])