{"id":17998871,"url":"https://github.com/quinta0/aequitasiq-","last_synced_at":"2026-02-09T18:04:07.112Z","repository":{"id":260122670,"uuid":"867809711","full_name":"Quinta0/AequitasIQ-","owner":"Quinta0","description":"A financial analysis tool that creates an interactive dashboard to visualize personal income and expenses","archived":false,"fork":false,"pushed_at":"2024-11-01T16:14:56.000Z","size":715,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T09:11:53.385Z","etag":null,"topics":["langchain-python","llm","machine-learning","nextjs14","numpy","ollama","pandas","python","sqlite"],"latest_commit_sha":null,"homepage":"","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/Quinta0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-04T19:04:57.000Z","updated_at":"2025-02-04T21:03:38.000Z","dependencies_parsed_at":"2024-10-29T17:50:02.578Z","dependency_job_id":null,"html_url":"https://github.com/Quinta0/AequitasIQ-","commit_stats":null,"previous_names":["quinta0/aequitasiq-"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quinta0%2FAequitasIQ-","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quinta0%2FAequitasIQ-/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quinta0%2FAequitasIQ-/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quinta0%2FAequitasIQ-/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Quinta0","download_url":"https://codeload.github.com/Quinta0/AequitasIQ-/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252863202,"owners_count":21815984,"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":["langchain-python","llm","machine-learning","nextjs14","numpy","ollama","pandas","python","sqlite"],"created_at":"2024-10-29T22:08:11.102Z","updated_at":"2026-02-09T18:04:03.486Z","avatar_url":"https://github.com/Quinta0.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AequitasIQ - Personal Finance Dashboard\n\nAequitasIQ is a comprehensive personal finance management system that helps you track expenses, manage bills, and gain insights into your financial health. Built with modern web technologies, it offers an intuitive interface for managing your finances with advanced features like AI-powered transaction categorization and financial advice.\n\n## Features\n\n- 📊 Interactive dashboard with expense tracking and visualization\n- 💰 Transaction management with automatic categorization\n- 📅 Bill tracking and recurring payment management\n- 📈 Financial insights and statistics\n- 🤖 AI-powered financial advisor\n- 📱 Responsive design for desktop and mobile\n- 📤 CSV import functionality\n- 🎯 Budget planning and tracking\n\n## Tech Stack\n\n### Frontend\n- Next.js 14 with App Router\n- TypeScript\n- TailwindCSS\n- shadcn/ui components\n- Recharts for data visualization\n- React Query for state management\n\n### Backend\n- FastAPI\n- SQLAlchemy\n- SQLite database\n- LangChain with Ollama for AI features\n- Pandas for data processing\n\n## Quick Start\n\n### Prerequisites\n- Docker and Docker Compose\n- Git\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/Quinta0/AequitasIQ-.git\ncd AequitasIQ-\n```\n\n2. Start the application using Docker Compose:\n```bash\ndocker compose up --build\n```\n\nThe application will be available at:\n- Frontend: http://localhost:3000\n- Backend API: http://localhost:8000\n- API Documentation: http://localhost:8000/docs\n\n## Development Setup\n\n### Frontend\n\n1. Navigate to the frontend directory:\n```bash\ncd frontend\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Start the development server:\n```bash\nnpm run dev\n```\n\n### Backend\n\n1. Navigate to the backend directory:\n```bash\ncd backend\n```\n\n2. Create a virtual environment:\n```bash\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n```\n\n3. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n4. Start the development server:\n```bash\nuvicorn main:app --reload\n```\n\n## Project Structure\n\n```\n.\n├── frontend/\n│   ├── app/\n│   ├── components/\n│   ├── lib/\n│   ├── public/\n│   └── types/\n├── backend/\n│   ├── models/\n│   ├── schemas/\n│   ├── services/\n│   ├── crud/\n│   └── main.py\n└── data/\n```\n\n## Features Documentation\n\n### Dashboard\nThe dashboard provides an overview of your financial health with:\n- Monthly expense trends\n- Income vs. expense comparison\n- Recent transactions\n- Upcoming bills\n- Financial metrics like savings rate\n\n### Transaction Management\n- Add, edit, and delete transactions\n- Automatic categorization using AI\n- Bulk import via CSV\n- Filter and search capabilities\n- Transaction history visualization\n\n### Bill Management\n- Track recurring and one-time bills\n- Set up payment reminders\n- Categorize bills\n- View upcoming payments in calendar view\n\n### Financial Insights\n- Category-wise expense breakdown\n- Income source analysis\n- Savings rate tracking\n- Budget vs. actual spending comparison\n- Custom date range analysis\n\n### AI Financial Advisor\n- Get personalized financial advice\n- Analyze spending patterns\n- Receive budgeting recommendations\n- Smart transaction categorization\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\nIf you encounter any issues or have questions, please:\n1. Search existing [Issues](https://github.com/Quinta0/AequitasIQ-/issues)\n2. Create a new issue if needed\n\n## Acknowledgments\n\n- [shadcn/ui](https://ui.shadcn.com/) for the UI components\n- [Recharts](https://recharts.org/) for the charting library\n- [Ollama](https://ollama.ai/) for the AI capabilities","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquinta0%2Faequitasiq-","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquinta0%2Faequitasiq-","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquinta0%2Faequitasiq-/lists"}