whatsmynote 0.1.1

A CLI app for managing notes and finances using LLMs.

WhatsMyNote

An intelligent, fully conversational financial memory system. Control your lending, borrowing, expenses, income, and transfers through pure natural language via CLI.

View on PyPI · Report Bug · Request Feature

---

📑 Table of Contents

• About The Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Local Development
• Roadmap
• License

---

🌟 About The Project

Tracking finances shouldn't require complex spreadsheets or clunky UIs. WhatsMyNote brings the power of state-of-the-art Large Language Models (LLMs) directly to your terminal. Just type what happened naturally, and the AI will extract the financial intent, validate it, and persist it to a database securely.

🏗 Built With

• Python for core logic
• LangGraph & LangChain for robust stateful intent routing and HITL (Human-in-the-Loop) flows
• Pydantic for extraction validation
• SQLAlchemy & PostgreSQL for data persistence
• Groq LLMs (Llama 3) for lightning-fast, high-quality inference
• Supabase for secure Authentication

---

🚀 Getting Started

Prerequisites

You need Python 3.11 or higher installed on your machine.

Installation

The recommended way to install WhatsMyNote is directly from PyPI.

pip install whatsmynote

That's it!

---

💡 Usage

After installing, simply type whatsmynote in your terminal to start the conversational interface!

whatsmynote

On your very first run, it will automatically prompt you for your GROQ_API_KEY and securely save it. It will also help you set up your initial budgets and accounts.

Example Commands you can type:

• "I spent $15 on coffee today"
• "My friend John borrowed $50 from me"
• "Show me my expenses for this month"
• "Transfer $100 from Checking to Savings"

---

🛠 Local Development (For Contributors)

If you'd like to contribute to the codebase or run the backend completely locally, you'll need uv installed.

1. Clone the repo:

   git clone https://github.com/SarJ2004/WhatsMyNote.git
   

2. Set up your environment variables:

   cp .env.sample .env
   

   Fill in your database and API keys in .env.
3. Install all dependencies (including backend AI and DB libraries):

   uv sync
   

4. Run the app:

   python whatsmynote/app/chat.py
   

---

🗺 Roadmap

See the open issues for a list of proposed features and known issues. See CHANGELOG.md for version history.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.