notesollama  by andersrex

macOS app for local LLM integration with Apple Notes

created 1 year ago
689 stars

Top 50.3% on sourcepulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

This project enables users to interact with local Large Language Models (LLMs) via Ollama directly within Apple Notes. It targets macOS users who want to leverage AI for note-taking and content generation without leaving their native application.

How It Works

NotesOllama utilizes SwiftUI for its user interface and AXSwift to interact with Apple Notes through macOS's accessibility APIs. It communicates with a locally running Ollama instance using OllamaKit. This approach allows for seamless integration, enabling users to send prompts and receive AI-generated content directly within their notes.

Quick Start & Requirements

  • Install by opening the project in Xcode and running, or download the binary.
  • Requires Ollama running on http://localhost:11434 (default macOS port).
  • Custom Ollama endpoints can be configured via the NOTESOLLAMA_OLLAMA_BASE_URL environment variable.
  • Prompts can be customized by editing the commands.json file within the application bundle.

Highlighted Details

  • Integrates LLM capabilities directly into Apple Notes.
  • Leverages macOS accessibility APIs for deep integration.
  • Supports custom prompts and Ollama endpoint configuration.

Maintenance & Community

The project is maintained by Anders Rex. Support for development can be found via their other plugin, NotesCmdr.

Licensing & Compatibility

Licensed under the MIT License. This permissive license allows for commercial use and integration with closed-source applications.

Limitations & Caveats

The application is designed exclusively for macOS and relies on the stability of Apple's accessibility APIs, which can be subject to change with OS updates.

Health Check
Last commit

10 months ago

Responsiveness

1 week

Pull Requests (30d)
0
Issues (30d)
0
Star History
22 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.