Echo-Notes

Sync, Process, and Summarize Notes, Files, Emails Privately and automatically with local AI

A privacy-first voice-to-text, file, and note cleanup pipeline powered by local LLMs.

• Type or capture voice-to-text notes on your phone or laptop.
• Sync them to your home computer via Nextcloud, Syncthing, Rclone, or your method of choice.
• Or Drop emails, files, or articles into the folder.
• Then automatically clean, structure, summarize, or create To Do's with them using a local language model..

---

---

Project Status

• Unstable – Actively maintained, Continous Improvement, Use at your own risk
• Focus: Local-only automation, modular design

---

Why Echo-Notes?

For users who want:

• 100% local, private AI-based note and file processing
• Clean, modular architecture
• Can process .txt, .md, or .docx files

---

How It Works

[Voice or Text Input]  
       ↓
    [Sync]
       ↓
  [Local LLM] 
       ↓
[Daily & Weekly Processing]

---

Installation

Note: Echo-Notes has recently migrated to a new modular installer framework. The instructions below use the new installers. For information about migrating from the old installers, see MIGRATION.md.

Having trouble? See our Quick Installation Guide for simplified instructions and troubleshooting tips.

Note: The windows and mac installers have not been fully tested but "should" work.

Windows

# Download the installer
curl -O https://raw.githubusercontent.com/18c83fd3-25ea-4ed9-8205-2abeff9b3883/Echo-Notes/main/installers/install_windows.py

# Run the installer
python install_windows.py

Or download and run the installer executable from our releases page.

The Windows installer provides a graphical interface with options to:

• Choose installation directory
• Create desktop shortcuts
• Set up the Echo-Notes daemon service

Command-line options are also available:

python install_windows.py install --install-dir "C:\Echo-Notes" --no-shortcut --no-service

macOS

# Download the installer
curl -O https://raw.githubusercontent.com/18c83fd3-25ea-4ed9-8205-2abeff9b3883/Echo-Notes/main/installers/install_macos.sh

# Make it executable
chmod +x install_macos.sh

# Run the installer
./install_macos.sh

The macOS installer will:

• Create an application bundle (.app)
• Set up symlinks in /usr/local/bin
• Configure a LaunchAgent service

Command-line options:

./install_macos.sh --install-dir ~/Applications/Echo-Notes --no-app-bundle --no-symlinks --no-service

Linux

# Download the installer
curl -O https://raw.githubusercontent.com/18c83fd3-25ea-4ed9-8205-2abeff9b3883/Echo-Notes/main/installers/install_linux.sh

# Make it executable
chmod +x install_linux.sh

# Run the installer
./install_linux.sh

Alternatively, you can use our wrapper script which ensures uninstaller scripts are properly created:

# Download the wrapper script
curl -O https://raw.githubusercontent.com/18c83fd3-25ea-4ed9-8205-2abeff9b3883/Echo-Notes/main/install_echo_notes.sh

# Make it executable
chmod +x install_echo_notes.sh

# Run the wrapper script
./install_echo_notes.sh

The Linux installer will:

• Create desktop shortcuts and application menu entries
• Set up symlinks in ~/.local/bin
• Configure a systemd service (with autostart fallback)
• Update PATH environment variable

Command-line options:

./install_linux.sh --install-dir ~/echo-notes --no-shortcuts --no-symlinks --no-service

For advanced manual setup, see docs/manual_install.md.

Application List and Desktop Icon Fix

In some cases Echo is not showing up in application list or showing desktop icon after install. To fix run script:

# Permissions for the virtual environment:
sudo chmod -R 755 ~/Echo-Notes/echo_notes_venv/bin/

# Install the required dependency:
sudo ~/Echo-Notes/echo_notes_venv/bin/pip install python-docx

# Run Script
cp ~/Echo-Notes/create_desktop_entry.sh ~/
chmod +x ~/create_desktop_entry.sh
~/create_desktop_entry.sh

---

Uninstallation

See UNINSTALL.md for detailed uninstallation instructions.

---

Features

Daily note cleanup and structuring

Weekly summaries with actionable insights

Multiple file format support (.md, .txt, .docx) - See details

Custom prompts (see shared/prompts_config.json)

GUI Dashboard: Monitor, trigger, configure

Local LLM processing via LM Studio

Daemon support for background operation

---

Configuration

You can customize directories and behavior using environment variables:

Variable Description

ECHO_NOTES_DIR Location of synced notes ECHO_APP_DIR Application directory (optional)

export ECHO_NOTES_DIR="/your/notes/dir" process-notes generate-summary

---

Advanced Scheduling & Launchers

Echo-Notes supports built-in scheduling via a daemon and optional cron or systemd setups.

For full scheduling setup (cron/systemd, dashboard launchers), see docs/scheduling.md.

---

Dashboard

Features:

Daemon status

Manual trigger buttons

Logs viewer

See docs/dashboard.md for usage and troubleshooting.

---

Changelog

See CHANGELOG.md

---

License

MIT – free to use, modify, and share.

---

Contributing

Open to:

New AI processing modes

UX enhancements

Additional backends

PRs welcome.