Get emoji for a category.

Get or create the global storage instance.

Get transactions with optional filters.

Get the configured currency.

Parse amount with per-user currency settings.

Parse amount from CLI, supporting k suffix and currency.

Load data from JSON file.

Generate a goals report.

Temporarily replace global storage/recurring/goals/portfolio/converter with per-user instances, then run func(). This is needed for modul

Detect category from description text. Returns category key (e.g., 'food', 'transport'). Falls back to 'other' if no match.

Calculate progress details for a goal.

Save data to JSON file.

Convert amount between currencies. Returns (converted_amount, exchange_rate).

Get recurring expenses due today.

Generate portfolio report.

Sends a text message to the user.

Discover skills by scanning for directories containing SKILL.md. Searches both direct children and one level deeper (skills/<name>/SKILL.md).

Format amount with currency symbol.

Format an error message.

Search transactions by description.

Get or create per-user finance instances.

Remove a transaction from the markdown file.

Add a new transaction. Returns the created transaction.

Compare current period to previous period.

Get all goals.

Get current exchange rates (cached or fresh).

Get all recurring expenses.

Calculate spending velocity and project end-of-period totals.

Return formatted list of all categories.

Add transaction to markdown file.

Calculate the next due date.

Add or update an asset.

Add a new savings goal. Args: name: Name of the goal (e.g., "New Laptop") target_amount: Target amou

Log income.

Add a recurring expense. Args: amount: Amount in currency units description: Description of the expe

Analyze spending trends over the given period. Returns insights about patterns.

Use ZhipuAI API for chat completion

Compare spending between two periods. Period 1 is the recent period, Period 2 is before that.

Delete a specific transaction by ID.

Detect unusual spending patterns.

Edit an existing transaction. Returns updated transaction or None.

Export all transactions as CSV.

Generate a spending report for the given period. Supports: today, yesterday, week, last-week, month, last-month, last-2-months

Get all assets.

Check spending against a daily budget.

Get formatted rate information.

Generate a report of common exchange rates.

List recent transactions. Args: n: Number of transactions to show storage: Optional storage instance Returns:

Parse amount string that might include currency. Returns (amount_in_default_currency, original_currency). Examples:

Process all due recurring expenses. Returns list of logged transactions.

Remove an asset.

Remove a goal.

Remove or deactivate a recurring expense.

Search transactions and return formatted results. Args: query: Search query storage: Optional storage instance

Set the currency.

Set the current amount of a goal (not add).

Remove the last transaction. Returns the removed transaction or None.

Add to the current amount of a goal.

Build per-user environment overrides for skill data isolation.

Build stats dict from a filtered list of transactions.

Execute a tool and return the result string to feed back to LLM.

Fetch and extract main text content from a URL (free, no API key).

Fetch current exchange rates from API.

Format search results with full page content scraped from each URL.

Format a list of {title, body, href} dicts into readable text.

Build set of allowed binary paths from registered skills (cached).

Extract the article's title, time, and content. Args: article_url: The URL of the article. Returns:

Retrieve the latest article URL. Returns: The full URL of the latest article or None if not found.

Get per-user data directory.

Icrawler for google search images (Free)

Initialize data files if they don't exist.

Create initial markdown file.

Check the image url is valid or invalid

Check if the given URL already exists in the text file. Args: url: The article URL to check. Returns:

Load rates from cache if still valid.

Load skill metadata (name, description, paths) from a skill directory.

Parse period string into (start_date, end_date, title). Supports: - today, yesterday, week, month, year, all - last-N-days,

Save the article URL to the text file. Args: url: The article URL to save.

Save rates to cache.

Serpapi for google search images