rogs/matrix-bot
rogs/matrix-bot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
matrix-bot/README.md

2.0 KiB
Raw Blame History

Matrix Bot

Matrix Bot

A Matrix bot that helps manage TODOs, track expenses, monitor bank accounts, save links, and interact with AI services - all while storing data in org-mode files.

Features

  • TODO Management: Create and track TODOs with different categories

    • !todo - Regular todos
    • !repeat - Repeating tasks
    • !next - Next actions
    • !waiting - Waiting for items
    • !someday - Future tasks
    • !proj - Project tasks

  • Task Lists: View your daily plan

    • !list free - Personal tasks
    • !list work - Work-related tasks

  • Financial Tracking:

    • !bofa - Check Bank of America account status

  • Link Management:

    • Auto-saves any shared URL to an org-mode file

  • AI Integration:

    • Chat with GPT-4 (continues conversation)
    • !reset - Reset chat history
    • !dalle - Generate images using DALL-E

Setup

  1. Install dependencies using Poetry:
poetry install
  1. Create a .env file with the following variables:
# Matrix Configuration
MATRIX_URL=
MATRIX_USER=
MATRIX_PASSWORD=
MATRIX_USERNAME=
MATRIX_USERNAMES=

# File Locations
EXPENSES_FILENAME=
ORG_LOCATION=
ORG_CAPTURE_FILENAME=
ORG_PLAN_FILENAME=
ORG_LINKS_FILENAME=

# API Keys
OPEN_AI_API_KEY=
  1. Run the bot:
python bot.py

Requirements

  • Python 3.9+
  • Poetry for dependency management
  • Matrix server access
  • Optional: Bank accounts with BROU and Itau for banking features
  • Optional: OpenAI API key for AI features

Project Structure

  • bot.py: Main bot implementation with command handlers
  • bofa.py: Bank of America data processing
  • org.py: Org-mode file management
  • settings.py: Environment configuration

Dependencies

Key dependencies include:

  • simplematrixbotlib: Matrix bot framework
  • orgparse: Org-mode file parsing
  • openai: GPT-4 and DALL-E integration
  • pyexcel-ods3: Spreadsheet processing
  • requests: API interactions