AI Notes & Task Manager

A powerful AI-enhanced note-taking and task management application with local storage, cloud backup, and intelligent features.

✨ Features

• 📝 Smart Note Taking: Create, edit, and organize notes with AI enhancement
• 🎯 Task Management: Track tasks with priorities and due dates
• 🔍 AI-Powered Search: Find notes using semantic search
• ☁️ Google Drive Backup: Automatic cloud synchronization
• 🖥️ Multiple Interfaces: Web app and native macOS app
• 🔒 Local Storage: All data stored locally with SQLite
• 🤖 AI Integration: Support for multiple AI providers (Ollama, Google Gemini)

🎬 Demo

Creating notes, managing tasks, and using AI features

🚀 Quick Start

Option 1: Web Application (Recommended)

1. Setup and Run:

   cd AI_Note_App
   ./run.sh setup       # First time only
   ./run.sh streamlit   # Start web app

2. Access: Open http://localhost:8501 in your browser

Option 2: Native macOS App

1. Setup and Run:

   cd AI_Note_App
   ./run.sh setup          # First time only (same as web)
   ./run_macos.sh macos    # Start macOS app

2. Desktop Launcher (Optional):

   • Double-click launch_ai_notes.command from Desktop
   • Or use the AppleScript launcher: AI_Notes_Launcher.applescript

📋 Prerequisites

• macOS (tested on macOS 14+)
• Python 3.8+ (automatically managed via virtual environment)
• Internet connection (for AI features and cloud backup)

🔧 Installation & Setup

Configure AI Provider (Optional)

Edit llm_config.json to change the active provider:

{
  "llm_provider": "ollama",  // Change to "gemini" for Google Gemini
  "providers": {
    "gemini": {
      "model_text": "gemini-1.5-flash",
      "model_embedding": "embedding-001",
      "api_key_required": true
    },
    "ollama": {
      "model_text": "llama3.1:8b", 
      "model_embedding": "nomic-embed-text",
      "base_url": "http://localhost:11434",
      "api_key_required": false
    }
  }
}

Google Drive Backup (Optional)

# Follow the setup guide
python setup_google_drive.py

For detailed Google Drive setup instructions, see GOOGLE_DRIVE_SETUP.md.

🎮 Usage Commands

Main Commands

# Web Application
./run.sh streamlit         # Start web interface

# macOS Native App
./run_macos.sh macos       # Start native app

# Setup & Maintenance
./run.sh setup             # Initial setup
./run.sh setup-ollama      # Setup Ollama models

🖥️ Interface Options

Web Interface (Streamlit)

• URL: http://localhost:8501
• Features: Full-featured web interface
• Best for: Daily use, cross-platform access

macOS Native App (PyQt6)

• Type: Native macOS application
• Features: System integration, dock icon, notifications
• Best for: Native macOS experience

MCP Server (Model Context Protocol)

• Type: Server interface for AI integration
• Features: Allows external tools to interact with your notes
• Best for: Integration with other AI tools and workflows
• Usage: Run python mcp_server.py to start the MCP server

⚙️ Configuration

AI Provider Setup

Ollama (Local AI)

# Install Ollama
brew install ollama

# Pull a model
ollama pull llama3.1:8b

# Update config - set llm_provider to "ollama"
{
  "llm_provider": "ollama"
}

Google Gemini (Cloud AI)

{
  "llm_provider": "gemini"
}

Get Gemini API Key:

1. Visit Google AI Studio
2. Create a new API key
3. Set up environment variable: export GEMINI_API_KEY="your-key-here"

Google Drive Backup

1. Run: python setup_google_drive.py
2. Follow the authentication flow
3. Automatic backups will be enabled

For detailed setup instructions, see GOOGLE_DRIVE_SETUP.md.

📁 Project Structure

AI_Note_App/
├── ai_note_app.py              # Main Streamlit app
├── macos_app.py                # Native macOS app
├── mcp_server.py               # Model Context Protocol server
├── run.sh                      # Web app launcher script  
├── run_macos.sh                # macOS app launcher script
├── build_app.sh                # App building script
├── launch_ai_notes.command     # Desktop launcher
├── AI_Notes_Launcher.applescript # AppleScript launcher
├── backup_ai_notes.command     # Manual backup script
├── requirements.txt            # Python dependencies
├── llm_config.json            # AI configuration
├── GOOGLE_DRIVE_SETUP.md      # Detailed Google Drive setup guide
├── core/                       # Core services
│   ├── agent_service.py        # AI agent logic
│   ├── ai_service.py           # AI provider interface
│   ├── database_service.py     # SQLite operations
│   ├── backup_service.py       # Google Drive backup
│   ├── search_service.py       # FAISS vector search
│   └── models.py               # Data models
├── backup_manager.py           # Backup utilities
├── setup_google_drive.py       # Google Drive setup
├── demo/                       # Demo files
├── backups/                    # Backup storage
├── notes.db                    # SQLite database
├── faiss.index                 # Search index
└── google_drive_credentials_template.json # Template for credentials

🔍 Troubleshooting

Common Issues

Virtual environment not found:

./run.sh setup

Port already in use:

# Stop any running Streamlit processes and restart
./run.sh streamlit

AI not working:

# Check Ollama
ollama list

# Or verify Gemini API key environment variable
echo $GEMINI_API_KEY

Google Drive issues:

python setup_google_drive.py

Logs & Debugging

• Check terminal output for detailed error messages
• Backup logs are in the backups/ directory
• Database issues: Delete notes.db to reset (loses data)

🆘 Getting Help

1. Check logs: Terminal output shows detailed error messages
2. Reset database: Delete notes.db if corrupted
3. Reinstall: Delete venv_mcp/ and run ./run.sh setup
4. Backup first: Always backup data before troubleshooting

� License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Quick Start Summary:

1. cd AI_Note_App
2. ./run.sh setup (first time)
3. ./run.sh streamlit (web) or ./run_macos.sh macos (macOS)
4. Open http://localhost:8501 (web) or use the native app window