Mrs Market 🧑🏻‍🏫

A Finance Chat App with Graph Support

A lightweight chat interface powered by an AI backend for answering finance-related questions.

Automatically displays AI-generated responses and renders graphs when provided.

US Mirror: https://mrsmarket1.livingit.sg

Asia mirror: https://mrsmarket.livingit.sg

🎬 Demo

output.mov

📦 Getting Started

1. Clone the Repository

git clone https://github.com/jiakai2002/fin-ai.git

2. Install requirements

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Database and keys

Create a .env file in the top-level directory. You may use .env.example as a template.

• OPENAI_API_KEY: your own API key from OpenAI. Mandatory.

• OPENAI_MODEL_NAME: gpt-4o-mini or better is recommended. Default: gpt-4o-mini

• DB_USER: of the PostgreSQL DB server user.

• DB_PASSWORD: of the PostgreSQL DB server user.

• DB_HOST: hostname of PostgreSQL DB server.

• Port is fixed at 5432, and database name is fixed as financial_db

Start the PostgreSQL DB server, then populate the database with:

cd src
python data/init_db.py

4. Start backend server

uvicorn server:app --reload

5. Launch frontend

Navigate to http://localhost:8000 You can now start chatting with Finance AI!

🖼️ Examples

• Ask about Apple's revenue
• 
• Compare an indicator across companies in a specific year
•