Observer  by Roy3838

Local AI micro-agents for observation, logging, and reaction

created 6 months ago
943 stars

Top 39.7% on sourcepulse

GitHubView on GitHub
Project Summary

Observer AI provides a platform for creating and running local, privacy-focused micro-agents that monitor user screens and react to events. It targets users who want to automate tasks or gain insights from their computer activity without sending data to external services. The benefit is localized, secure AI-driven automation.

How It Works

The system operates on a modular agent architecture, allowing users to define agents with specific "Sensors" (inputs like screen OCR, screenshots, clipboard, microphone), "Models" (LLMs run via Ollama), and "Tools" (functions for interaction). Agents are configured through a dashboard, with logic defined in either browser-based JavaScript or server-based Python, enabling diverse interaction capabilities from simple notifications to system-level commands.

Quick Start & Requirements

  • Install/Run: Recommended via Docker Compose. Clone the repo and run docker-compose up --build.
  • Prerequisites: Docker and Docker Compose installed.
  • Access: Web UI at http://localhost:8080. Requires accepting a self-signed SSL certificate for https://localhost:3838.
  • Docs: Observer App Link, Getting Started.

Highlighted Details

  • Supports local inference via Ollama integration.
  • Agents can be programmed in JavaScript (browser sandbox) or Python (Jupyter server for system access).
  • Includes built-in sensors for screen OCR, screenshots, clipboard, and microphone.
  • Provides tools for memory management, agent control, notifications, and communication (email, SMS, WhatsApp).

Maintenance & Community

Licensing & Compatibility

  • MIT License.
  • Permissive license suitable for commercial use and integration with closed-source applications.

Limitations & Caveats

  • Screen OCR and microphone transcription are currently limited to English only.
  • WhatsApp messaging is temporarily restricted to static messages due to anti-spam measures.
  • Python agents require a separate Jupyter server setup and configuration.
Health Check
Last commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
7
Issues (30d)
4
Star History
859 stars in the last 90 days

Explore Similar Projects

Starred by Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), and
1 more.

SuperAGI by TransformerOptimus

0.2%
17k
Open-source framework for autonomous AI agent development
created 2 years ago
updated 6 months ago
Feedback? Help us improve.