Overview

Open_Recall is a powerful desktop application that helps you search, find and analyze anything you've seen on your PC. Using advanced search capabilities, you can easily locate past activities, documents, applications, and websites based on your memory fragments or timeline navigation.
This is an open source alternative to 𝗠𝗶𝗰𝗿𝗼𝘀𝗼𝗳𝘁'𝘀 𝗥𝗲𝗰𝗮𝗹𝗹 𝗳𝗲𝗮𝘁𝘂𝗿𝗲 𝗶𝗻 𝗪𝗶𝗻𝗱𝗼𝘄𝘀 𝟭𝟭, designed with transparency and user control at its core.

Watch the Open_Recall Demo on YouTube

Project Structure

.
├── open_recall/           # Python package
│   ├── app.py             # Toga desktop app entry point
│   ├── cli.py             # Command-line interface
│   ├── main.py            # FastAPI application
│   ├── static/            # Static files (CSS, JS, images)
│   ├── templates/         # HTML templates
│   └── utils/             # Utility modules
├── pyproject.toml         # Python project configuration
├── setup.py               # Package setup configuration
├── requirements.txt       # Python dependencies
├── Makefile               # Development and build commands
└── README.md              # This file

Installation Options

Open_Recall can be installed and used in two ways:

1. Windows Desktop Application

For the best user experience with a native GUI:

1. Download the latest Windows installer from the Releases page
2. Run the installer and follow the on-screen instructions
3. Launch Open_Recall from your Start Menu or Desktop shortcut

2. Python Package (All Platforms)

For cross-platform usage or integration with other tools:

pip install open-recall-cli

After installation, you can use the open_recall command-line interface:

# Start the desktop application
open_recall desktop

# Start the server only
open_recall server

# Show version information
open_recall version

For more details on CLI usage, see CLI Documentation.

Configuration

Open_Recall uses port 8742 by default to avoid conflicts with other applications. You can change this in two ways:

1. Set the OPEN_RECALL_PORT environment variable:

   # Windows
   set OPEN_RECALL_PORT=9000
   
   # Linux/macOS
   export OPEN_RECALL_PORT=9000

2. Edit the config.json file in the application directory:

   {
     "app": {
       "port": 9000,
       "host": "localhost",
       "debug": false
     }
   }

Other configuration options:

• OPEN_RECALL_HOST: Change the host interface (default: localhost)
• OPEN_RECALL_DEBUG: Enable debug mode (set to "true")

Development

Setup Development Environment

1. Clone the repository:

   git clone https://github.com/Eng-Elias/Open_Recall.git
   cd Open_Recall

2. Install Python dependencies:

   pip install -r requirements.txt

3. Install the package in development mode:

   make install-dev
   # or
   pip install -e .

Available Make Commands

The project includes a Makefile with useful commands for development and packaging:

# Run the desktop application in development mode
make run_desktop

# Run the web server with hot reloading
make run_web_dev

# Build the desktop application with Briefcase
make build_desktop

# Package the application as a Windows installer
make package_desktop

# Install the package in development mode
make install_dev

# Build the Python package for PyPI
make pypi_build

# Upload the package to PyPI
make pypi_upload

# Clean build artifacts
make clean

Packaging and Distribution

Desktop Application (Windows)

To create a standalone Windows installer:

make package_desktop

The packaged installer will be available in the dist directory.

Python Package (PyPI)

To build and publish the Python package to PyPI:

make pypi-upload