FinTracker Bot is an LLM-powered chatbot that helps users manage their finances through intelligent conversations.It integrates with the FinTracker API to provide personalized insights and financial management tools.
- Multiple Platforms: Initially supporting a web-based widget, with plans to expand to a Telegram bot.
- LLM-Powered: Uses a Large Language Model (LLM) for natural language understanding and response generation.
- Financial Insights: Provides users with summaries of their financial data and spending analysis.
bot/
: Core chatbot logic (LLM interaction, API calls).platforms/
: Platform-specific implementations (Telegram, web GUI).config/
: (Optional) Configuration files for the bot.tests/
: Unit and integration tests.
-
Prerequisites:
- Python 3.7+
- Access to the FinTracker API (running locally)
- OpenAI API key
-
Installation:
- Setup the project in your local environment.
git clone https://github.com/cey-labs/fin-tracker-bot.git cd fin-tracker-bot pip install -r requirements.txt
- Create a
.env
file and add following variables.
OPENAI_API_KEY="<paste your OpenAI API key here>" FINTRACKER_BASE_URL="http://localhost:8000"
-
Running:
- Run
/bot/conversational_agent.py
to run bot in commandline.
- Run