Skip to content
Credevator edited this page Aug 15, 2025 · 4 revisions

Welcome to the Recaller Wiki

Recaller is a privacy-first, open-source personal assistant application designed to help you manage your finances, communications, social activities, belongings, and recurring paymentsβ€”all powered by on-device/self-hosted AI.

πŸ“š Documentation Overview

Getting Started

Architecture & Design

Features & Modules

Development

Advanced Topics

πŸš€ Key Features

Financial Management

  • Transaction Tracking: Credit/debit transactions with categorization
  • Recurring Payments: Automated EMIs, salary, and subscription management
  • Budget Management: Spending limits and alerts
  • Multi-Currency Support: International transaction handling
  • Financial Analytics: Insights and reporting

Personal Assistant

  • Task Management: To-dos, reminders, and recurring tasks
  • Contact Management: Personal and professional relationships
  • Event Tracking: Social activities and appointments
  • Belongings Management: Inventory and asset tracking
  • AI Integration: LLM-powered assistance via MCP server

Privacy & Security

  • On-Device AI: No data sent to third-party services
  • Self-Hosted: Complete control over your data
  • Multi-Tenant: Secure isolation for organizations
  • Open Source: Transparent and extensible
  • MCP Protocol: Standardized LLM integration with privacy-first design

πŸ—οΈ Technology Stack

Backend

  • Framework: FastAPI (Python)
  • Database: PostgreSQL with SQLAlchemy ORM
  • Cache: Redis for session and task management
  • Background Tasks: Celery for automated processing
  • Authentication: JWT-based with multi-tenant support

Frontend

  • Framework: React 19+ with TypeScript
  • Styling: Tailwind CSS
  • UI Components: Headless UI, Heroicons
  • HTTP Client: Axios with interceptors
  • State Management: React Context and hooks

Infrastructure

  • Containerization: Docker and Docker Compose
  • Database Migrations: Alembic
  • API Documentation: OpenAPI/Swagger
  • Background Processing: Celery + Redis
  • Email Notifications: SMTP integration
  • MCP Server: Model Context Protocol for LLM integration

πŸ“ˆ Recent Updates

MCP Server Integration (August 2025)

  • Model Context Protocol: Standardized LLM integration with MCP v1 compliance
  • Multi-Backend Support: Ollama, HuggingFace, OpenAI-compatible APIs
  • Privacy-First AI: On-device processing with zero external data sharing
  • Tenant Isolation: Complete model access control per tenant
  • Extensible Architecture: Plugin-based system for custom backends

Financial Transactions Management System (August 2025)

  • Complete financial management module with 6 database tables
  • Advanced transaction categorization and subcategorization
  • Automated recurring transaction processing
  • Budget tracking with alerts and notifications
  • Multi-currency support and analytics
  • Email reminders for upcoming payments

Multi-Tenant Architecture

  • Tenant-based data isolation
  • User access control within tenants
  • API-level tenant filtering
  • Background task tenant isolation

🀝 Community & Support

πŸ”— Quick Links


Last updated: August 15, 2025 Built with ❀️ for privacy and productivity.