Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sandramsc/finpal

FinPAL - Your Finance Ally
https://github.com/sandramsc/finpal

gemini-ai trulens

Last synced: 7 days ago
JSON representation

FinPAL - Your Finance Ally

Awesome Lists containing this project

README

        

FinPAL



FinPAL - Your Telegram Finance Ally


## Application Description

Introducing FinPAL, your dedicated Financial Assistant Telegram bot meticulously crafted to offer unparalleled financial guidance and support. Harnessing the cutting-edge Trulens eval llm monitoring technology, FinPAL is engineered to deliver contextually rich and actionable financial advice. Powered by advanced algorithms and user-friendly functionalities, it stands out with unique features tailored for a seamless user experience.

## Table of Contents

FinPAL

- [Application Description](#application-description)
- [Table of Contents](#table-of-contents)
- [Project Demo](#demo)
- [Screenshots](#screenshots)
- [Technology Stack](#technology-stack)
- [Features](#features)
- [Collaborators](#collaborators)
- [References](#references)
- [License](#license)

## Web App Video Demo

[View the Demo](https://youtu.be/yoyppkJUK7Q)

## Web App

[Landing page](https://finpallandingpage.vercel.app/)

[Dashboard](https://finpaldash.vercel.app/dashboard/user_id/test/start_date/20230101/end_date/20231212)

## Screenshots

![imageedit_5_5332482570](https://github.com/sandramsc/FinPAL/assets/19821445/02888c94-44e2-44de-929a-743d5c6a0871)
![land2](https://github.com/sandramsc/FinPAL/assets/19821445/8e95b172-7fdf-4d56-beb2-8efbc7903d48)
![uploa](https://github.com/sandramsc/FinPAL/assets/19821445/729e52e5-796a-49d5-8b5e-b42cdfcf9d25)
![sub11](https://github.com/sandramsc/FinPAL/assets/19821445/1028af3b-7a60-4e77-9f84-92c131c55200)
![sub22](https://github.com/sandramsc/FinPAL/assets/19821445/66b51c38-64c3-49b9-aae5-66906711e063)
![sub33](https://github.com/sandramsc/FinPAL/assets/19821445/82f2c756-0919-450c-82c2-8523e5099277)
## Technology Stack

| Technology | Description |
| ----------- | ------------------------ |
| Material-UI | React UI library |
| TypeScript | Object-oriented language |
| React.js | JavaScript library |
| Python | a high-level, general-purpose programming language |
| FastAPI | a modern web framework for building RESTful APIs in Python |
| Qdrant | a vector similarity search engine |
| Prisma | Next-generation ORM for Node.js & TypeScript |
| Pyrogram | a modern, elegant and asynchronous MTProto API framework. |
| TgCrypto | a Cryptography Library written in C as a Python extension |
| Google Generative AI | a category of artificial intelligence that can create new text, images, video, audio, or code |
| Matplotlib | a comprehensive library for creating static, animated, and interactive visualizations in Python |
| TruLens-Eval | an open source library for evaluating and tracking the performance of LLM apps, such as RAGs. |

## Features

1. FinPAL boasts a sophisticated suite of features designed for seamless financial management.
2. FinPAL with Trulens eval llm monitoring, we have a robust llm monitoring system in place, get automated and measurable feedback on how the llm is performing.
3. Integration with Telegram to ensure effective communication right in user pocket.
4. Ability to save transaction receipts through chat or photo to add a practical touch.
5. Generate transaction charts effortlessly through chat, and smoothly query transaction data for comprehensive financial insights.

## How to use the FinPAL Telegram bot

1. Initiate a conversation with the bot with a text prompt i.e /start command.

2. Participate in financial dialogues with the bot, receiving guidance and responses on personal finance topics.

![qr_tmp_1_-removebg-preview](https://github.com/sandramsc/sandramsc/assets/19821445/78d4e721-8960-4f1a-bbbb-7f6c821821a8)

## How to use the app

**Step #1** - Clone the project

```bash
$ git clone https://github.com/sandramsc/FinPAL.git
```

**Step #2**

- Fill in all .env

- Start docker compose

```
docker compose -f compose.local.yml up
```

- Install dependencies in both frontend and backend folders: `npm i` OR `yarn`

- To start the webapp, run: `npm start` OR `yarn start`

## Authors

| Name | Link |
| --------------- | ------------------------------------------- |
| Sandra Ashipala | https://www.linkedin.com/in/sandraashipala/ |
| Viky Wahjoedin | https://www.linkedin.com/in/vikyweb/ |

## License

[![GitLicense](https://img.shields.io/badge/License-MIT-lime.svg)](https://github.com/sandramsc/FinPAL/blob/master/LICENSE.md)