ATLES-ECHO 🧠

Your Semantic Digital Twin - An intelligent system that captures, understands, and learns from your digital life.

🌟 Features

ATLES-ECHO is a semantic monitoring system that creates a searchable, AI-powered memory of everything you do:

Core Capabilities

• 📁 File Monitoring - Tracks code changes, documents, and project files
• 🖥️ Screen Capture - OCR-based screen content extraction
• ⌨️ Keystroke Monitoring - Context-aware typing patterns (privacy-focused)
• 📋 Clipboard Tracking - Saves copied text and code snippets
• 🪟 Application Monitoring - Tracks app usage and focus time
• 🔍 Semantic Search - Natural language search across all captured data
• 📊 Auto-Generated Reports - Daily summaries, pattern analysis, productivity insights

Technology Stack

• Backend: FastAPI, Python 3.11+
• Frontend: React 18, TypeScript, Vite, TailwindCSS
• Embeddings: spartan8806/atles-champion-embedding (768-dim)
• Vector DB: FAISS (Facebook AI Similarity Search)
• Knowledge Store: SQLite
• Monitoring: watchdog, mss, pytesseract, pynput, pywin32

🚀 Quick Start

Prerequisites

• Python 3.11 or higher
• Node.js 18 or higher
• Tesseract OCR (for screen text extraction)

Installation

# Clone the repository
git clone https://github.com/spartan8806/atles-echo.git
cd atles-echo

# Install backend dependencies
cd backend
pip install -r requirements.txt

# Install frontend dependencies
cd ../frontend
npm install

Configuration

Create a backend/.env file:

# API Configuration
API_PORT=5001
API_HOST=0.0.0.0

# Data paths
DATA_DIR=../data
WATCH_PATHS=["D:\\.atles"]

# Model configuration
EMBEDDING_MODEL=spartan8806/atles-champion-embedding
EMBEDDING_DIMENSION=768

# Feature toggles
ENABLE_SCREEN_MONITOR=true
ENABLE_KEYSTROKE_MONITOR=true
ENABLE_CLIPBOARD_MONITOR=true
ENABLE_APP_MONITOR=true

Running ATLES-ECHO

Option 1: Development Mode

# Terminal 1: Start backend
cd backend
python -m uvicorn main:app --reload --host 0.0.0.0 --port 5001

# Terminal 2: Start frontend
cd frontend
npm run dev

Option 2: Using the startup script

# Windows
.\start_echo.bat

# Linux/Mac
chmod +x start_echo.sh
./start_echo.sh

Access the dashboard at: http://localhost:3000

📖 Documentation

• Installation Guide
• Configuration
• API Documentation
• Architecture Overview
• Privacy Analysis
• Cloudflare Tunnel Setup

🔒 Privacy & Data

IMPORTANT: ATLES-ECHO is designed for personal use only. All data stays on your machine.

• ✅ Local-first: All data stored locally in ./data/
• ✅ No cloud uploads: Nothing leaves your machine unless you configure it
• ✅ Full control: Delete data anytime, configure what's monitored
• ✅ Open source: Audit the code yourself

What Data is Collected?

By default, ATLES-ECHO monitors:

• File changes in configured directories
• Screen content (via OCR)
• Clipboard text (optional)
• Application usage (app names and window titles)
• Keystroke buffers (configurable whitelist)

You can disable any monitor via backend/config.py.

🛠️ Development

Project Structure

atles-echo/
├── backend/           # FastAPI backend
│   ├── main.py       # Main API server
│   ├── config.py     # Configuration
│   ├── models.py     # Pydantic models
│   └── auth.py       # Authentication
├── core/             # Core functionality
│   ├── embedding_engine.py
│   ├── vector_db.py
│   └── knowledge_base.py
├── watchers/         # Monitoring modules
│   ├── file_watcher.py
│   ├── screen_monitor.py
│   ├── clipboard_monitor.py
│   ├── keystroke_monitor.py
│   └── app_monitor.py
├── frontend/         # React frontend
│   └── src/
│       ├── pages/
│       └── components/
└── docs/            # Documentation

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📊 Example Use Cases

• Developers: Track code changes, debug sessions, research snippets
• Writers: Monitor document edits, research notes, writing patterns
• Researchers: Organize papers, notes, and reading sessions
• Knowledge Workers: Build a searchable memory of your work

🗺️ Roadmap

• Multi-language support
• Browser history integration
• Email integration (local)
• Voice memo capture
• Advanced pattern detection
• LLM integration for insights
• Cross-platform support (macOS, Linux)
• Mobile companion app

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

• Embedding Model: spartan8806/atles-champion-embedding
• FAISS: Facebook AI Research
• FastAPI: Sebastián Ramírez
• React: Meta

💬 Support

• 🐛 Issues: GitHub Issues

---

Made with ❤️ for knowledge workers

"Your digital life, remembered."