{"id":23742868,"url":"https://github.com/adhamafis/curiopay","last_synced_at":"2025-10-06T10:31:49.503Z","repository":{"id":269182134,"uuid":"883663920","full_name":"AdhamAfis/curiopay","owner":"AdhamAfis","description":"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!","archived":false,"fork":false,"pushed_at":"2025-01-06T13:44:12.000Z","size":1495,"stargazers_count":8,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-24T23:49:40.667Z","etag":null,"topics":["budget","budget-tracker","cohere","gorq","groq-api","llm","next-auth","nextjs","ollama","ollama-api","prisma","rag"],"latest_commit_sha":null,"homepage":"https://curiopay.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdhamAfis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-05T11:11:33.000Z","updated_at":"2025-01-07T16:48:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"bd7fec22-de8e-453e-a4e4-1d64e5a2ff71","html_url":"https://github.com/AdhamAfis/curiopay","commit_stats":null,"previous_names":["adhamafis/curiopay"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdhamAfis%2Fcuriopay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdhamAfis%2Fcuriopay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdhamAfis%2Fcuriopay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdhamAfis%2Fcuriopay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdhamAfis","download_url":"https://codeload.github.com/AdhamAfis/curiopay/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235519903,"owners_count":19003201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["budget","budget-tracker","cohere","gorq","groq-api","llm","next-auth","nextjs","ollama","ollama-api","prisma","rag"],"created_at":"2024-12-31T11:48:12.120Z","updated_at":"2025-10-06T10:31:49.498Z","avatar_url":"https://github.com/AdhamAfis.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Curiopay: Open Source Budget Tracking App with LLM Insights  \r\n\r\n\u003e **🚀 ANNOUNCEMENT**: CurioPay is getting a new backend with improved security, performance, and enhanced features coming soon!\r\n\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)  [![Status: Active](https://img.shields.io/badge/Status-Active-success.svg)](https://github.com/adhamafis/curiopay)  [![TypeScript](https://img.shields.io/badge/TypeScript-5.2.2-blue.svg)](https://www.typescriptlang.org/)  [![Next.js](https://img.shields.io/badge/Next.js-14.0.4-black.svg)](https://nextjs.org/)  [![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.4.0-38B2AC.svg)](https://tailwindcss.com/)  \r\n\r\nCuriopay 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.  \r\n\r\n---\r\n\r\n## Key Features  \r\n\r\n- **Expense Tracking**: Log income and expenses with categories and dates.  \r\n- **Budget Alerts**: Real-time notifications and email alerts when budgets are exceeded.  \r\n- **AI Financial Insights**: Chat with LLMs for personalized spending advice.  \r\n- **Recurring Expenses**: Automate daily, weekly, or monthly expense tracking.  \r\n- **Data Export**: Save data in CSV or JSON formats.  \r\n- **Secure and Private**: Local deployment ensures complete control of your financial data.  \r\n- **New Backend Coming Soon**: Enhanced security, improved performance, and expanded capabilities.\r\n\r\n### In Progress  \r\n- Responsive mobile-friendly design and themes.  \r\n- Expanded LLM provider support.  \r\n- Backend infrastructure upgrade.\r\n\r\n### Planned  \r\n- Mobile app development.  \r\n- Receipt scanning for automatic expense entry.  \r\n- Advanced analytics like predictive spending trends.  \r\n\r\n---\r\n\r\n## Installation  \r\n\r\n### Prerequisites  \r\n- **Node.js** (v14+)  \r\n- **npm**  \r\n- **Docker** (for local PostgreSQL server)  \r\n\r\n### Quick Setup  \r\n\r\n1. Clone the repository:  \r\n   ```bash  \r\n   git clone https://github.com/adhamafis/curiopay.git  \r\n   cd curiopay  \r\n   ```  \r\n\r\n2. Run the setup script:  \r\n   ```bash  \r\n   ./setup.sh  \r\n   ```  \r\n   The script:  \r\n   - Configures environment variables (`.env` file).  \r\n   - Sets up a local PostgreSQL database with Docker.  \r\n   - Guides you through API keys and email setup.  \r\n---\r\n\r\n## Usage  \r\n\r\n- Log and categorize your income and expenses.  \r\n- Set budgets and receive alerts if exceeded.  \r\n- Interact with AI for spending insights.  \r\n- Export your data for offline analysis.  \r\n\r\n---\r\n\r\n## Contributing  \r\n\r\nContributions are welcome! Here's how to get started:  \r\n\r\n1. **Fork and Clone** the repository:  \r\n   ```bash  \r\n   git clone https://github.com/adhamafis/curiopay.git  \r\n   cd curiopay  \r\n   ```  \r\n\r\n2. **Create a new branch**:  \r\n   ```bash  \r\n   git checkout -b feature/new-feature  \r\n   ```  \r\n\r\n3. **Make your changes** and commit:  \r\n   ```bash  \r\n   git commit -am \"Add new feature\"  \r\n   ```  \r\n\r\n4. **Push and create a pull request**.  \r\n\r\nEvery contribution—big or small—makes Curiopay better!  \r\n\r\n---\r\n\r\n## License  \r\n\r\nCuriopay is licensed under the [MIT License](LICENSE).  \r\n\r\n---\r\n\r\n## Contact  \r\n\r\nFor questions or suggestions:  \r\n**Email**: [adham.afis@gmail.com](mailto:adham.afis@gmail.com)  \r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadhamafis%2Fcuriopay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadhamafis%2Fcuriopay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadhamafis%2Fcuriopay/lists"}